Changes for page ONEcount Javascript Widgets
Last modified by Admin User on 2025/10/31 14:02
From version 13.1
edited by Admin User
on 2025/10/31 14:02
on 2025/10/31 14:02
Change comment:
There is no comment for this version
To version 9.1
edited by mikef
on 2017/09/25 18:29
on 2017/09/25 18:29
Change comment:
There is no comment for this version
Summary
-
Page properties (3 modified, 0 added, 0 removed)
-
Objects (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Parent
-
... ... @@ -1,1 +1,0 @@ 1 -System Setup Detail and Technical Information - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. admin1 +XWiki.mikef - Content
-
... ... @@ -5,13 +5,15 @@ 5 5 6 6 (updated 10/12/16) 7 7 8 + 8 8 9 -** oc.min.js**: This is the main script that's used for data collection, interacting with ONEcount.10 +**all.min.js**: This is the main script that's used for data collection, interacting with ONEcount. 10 10 11 11 The main object in this script is called **GCN**. **GCN** contains the following objects: 12 12 13 13 (% style="margin-left: 30.0px;" %) 14 14 **variables**: this is a container for variables that may be used by others objects in GCN 16 +\\ 15 15 16 16 (% style="margin-left: 30.0px;" %) 17 17 **cookie**: utility for interacting with cookies. Contains the following functions: ... ... @@ -24,7 +24,8 @@ 24 24 **set**(**name**, **value**, **options**): create a cookie called **name** with value **value**. **options** is an object which can have **expires**, **path**, **domain** and **secure** properties 25 25 ))) 26 26 * ((( 27 -**remove**(**name**, **options**): removes the cookie **name**. **options** is an object which can have the property **sublevel** 29 +**remove**(**name**, **options**): removes the cookie **name**. **options** is an object which can have the property **sublevel 30 +\\** 28 28 ))) 29 29 ))) 30 30 ... ... @@ -46,8 +46,8 @@ 46 46 ))) 47 47 ))) 48 48 52 + 49 49 50 - 51 51 (% style="margin-left: 30.0px;" %) 52 52 **script**: utility for interacting with scripts. Contains the following functions: 53 53 ... ... @@ -62,7 +62,7 @@ 62 62 **addAsync**(**url**): create a script tag in the **body** whose **src** is **url** 63 63 ))) 64 64 * ((( 65 -**createScript**(**url**): helper function that create a script element whose src is url 68 +**createScript**(**url**): helper function that create a script element whose src is url\\ 66 66 ))) 67 67 ))) 68 68 ... ... @@ -71,7 +71,8 @@ 71 71 72 72 * ((( 73 73 * ((( 74 -**call**(**f**, **options**): calls the function **f** 77 +**call**(**f**, **options**): calls the function **f 78 +\\** 75 75 ))) 76 76 ))) 77 77 ... ... @@ -84,6 +84,7 @@ 84 84 ))) 85 85 * ((( 86 86 **off**(**type**, **listener**, **f**): removes the listener that executes the function **f** when event of type **type** occurs 91 +\\ 87 87 ))) 88 88 ))) 89 89 ... ... @@ -96,6 +96,7 @@ 96 96 ))) 97 97 * ((( 98 98 **string**(**count**): return a random string of length **count** 104 +\\ 99 99 ))) 100 100 ))) 101 101 ... ... @@ -108,6 +108,7 @@ 108 108 ))) 109 109 * ((( 110 110 **track**(**url**, **title**, **referer**): used to dynamically track a page with url **url**, title **title** and referer **referer**. This can be used with **infinite scroll**. 117 +\\ 111 111 ))) 112 112 ))) 113 113 ... ... @@ -115,7 +115,7 @@ 115 115 **ONEcount**: object for interacting with ONEcount application. This object contains many functions and objects. 116 116 117 117 (% style="margin-left: 60.0px;" %) 118 -a.** Functions**:125 +a.** Functions**: 119 119 120 120 * ((( 121 121 * ((( ... ... @@ -156,14 +156,15 @@ 156 156 ))) 157 157 ))) 158 158 166 + 159 159 160 - 161 161 (% style="margin-left: 60.0px;" %) 162 -b. ** Objects**169 +b. ** Objects** 163 163 164 164 * ((( 165 165 * ((( 166 166 **urls**: this object contains all the url used to interact with ONEcount. These url already have the **clientId** appended to them. 174 +\\ 167 167 ))) 168 168 * ((( 169 169 **links:** this object contains links to the login/logout in ONEcount. Below are the functions: ... ... @@ -180,6 +180,7 @@ 180 180 ))) 181 181 * ((( 182 182 This also contains other helper functions such as **setReturn**(**returnUrl**), **getReturnParam**(**returnUrl**), **encodeUrl**(**url**), **decodeUrl**(**url**) 191 +\\ 183 183 ))) 184 184 ))) 185 185 ))) ... ... @@ -188,60 +188,62 @@ 188 188 * ((( 189 189 **modal**: used to create a modal. This is being used for the form popup and the custom targeting pop up Contains the following functions: 190 190 191 -* 200 +* 192 192 193 193 **create**(**options**): create a modal. options is an object that contains the properties **html**, **styles**, **close** 194 194 195 -* 204 +* 196 196 197 197 **getCloseButton**(**options**): return the close button element. **options** is an object that contains the properties **close** 198 198 199 -* 208 +* 200 200 201 201 **getContent**(**options**): return a div that contains the content of the modal. **options** is an object that contains the properties **html** 202 202 203 -* 212 +* 204 204 205 -**loadStyles**(**options**): load css styles used for the modal. **options** is an object that contains the properties **style** 214 +**loadStyles**(**options**): load css styles used for the modal. **options** is an object that contains the properties **style 215 +\\** 206 206 ))) 207 207 * ((( 208 208 **functions**: this is an object contains functions used by other widgets on the page. Contains the following functions: 209 209 210 -* 220 +* 211 211 212 212 **dfp_sb_ad_capture**(**e**): used to prepare data for **DFP Small Business** viewability script. e is and event containing data about the data (**creativeId**, **lineItemId**) 213 213 214 -* 224 +* 215 215 216 -**get_user_data()**: returns the user's **ocid** and **tempid** in the format **ocid.tempid** 226 +**get_user_data()**: returns the user's **ocid** and **tempid** in the format **ocid.tempid 227 +\\** 217 217 ))) 218 218 * ((( 219 219 **form**: used to create a pop up form or for form embed. Contains one function and another object: 220 220 221 -* 232 +* 222 222 223 223 **embed**(**options**): this function is used to embed a form on the page 224 224 225 -* 236 +* 226 226 227 227 **popup:** this object is used to display the form as a popup. Contains the following functions: 228 228 229 -* 240 +* 230 230 231 231 **resize**(**id**): re sizes the form with document id **id** 232 232 233 -* 244 +* 234 234 235 235 **display**(options): displays the form as a pop up 236 236 237 -* 248 +* 238 238 239 239 **message**(event): used to interact with the form in the iframe via **postMessage** 240 240 ))) 241 241 ))) 242 242 254 + 243 243 244 - 245 245 On top of this **all.min.js** also contains a library used for browser fingerprinting as well as a library used for getting flash info on the browser. The content of this files used to spread in 3 different files and now they're in one place. 246 246 247 247 **v.js:** This script is used to capture viewability data for **DFP Premium** and **Openx Open Source (Revive)**. ... ... @@ -250,46 +250,57 @@ 250 250 251 251 **fs.js:** This is the form scrapper script. Used to scrapped content from 3^^rd^^ party forms when they are being submitted. 252 252 253 - ===GCN.onecount.track(url, title, referrer, resourceId, callback): ===264 + 254 254 255 - Bydefault,ONEcountwidgets trackimpressionson eachpage load.For siteswhere one article isdisplayed perpage,thisworksfine.Butincaseswhere articles are displayedon thesamepage,i.e.infinitescroll,only thefirst one istracked.266 +**__NOTE:__** If page load speed is ever a concern, it is recommended to use a third party service (such as tools.pingdom.com). By doing so, it will generate report of all items loading on your webpage along with their load times. Simply copy and paste your page's URL into the designated field and a test will be conducted immediately. If any** oc.net** item exceeds a load speed of 500ms, please enter a Helpdesk ticket for us to review. Testing page load speeds is a very informative way of identifying items that are directly impacting page performance. It is worth mentioning that there will be items that continuously load in short spurts (ex. **v.js** for viewability data) however those short spurts do not negatively impact load speed performance. 256 256 257 - Thisfunction is designed to provide an impression track for each article on a page. The function expects three parameters:268 + 258 258 259 -* **url**: The url of the article that is supposed to be tracked. **This is required**. 260 -* **title**: This should be the same as the **title tag** if the article was displayed alone on the page. 261 -* **referrer**: The referrer of article. (For infinite scroll this can be the previous article in the scroll.) 262 -* ((( 263 -**resourceId**: this is optional. If set to a valid resourceId, that resource that will be used in order to perform gating or increase view_count. You can pass 0 in order to use the default resource associated with the url if any 264 -))) 265 -* ((( 266 -**callback**: function to be called after a request has been sent to ONEcount. This can return the number of articles read by the user for products with limit in timeframe 267 -))) 270 +\\ 271 +{{/layout-cell}} 268 268 269 -While the impressions are being tracked, ONEcount will also check whether the user's subscription is still valid or not (e.g. limit of X articles per month has been reached). If the subscription is not valid, then the user will be taken to the subscription page. 273 +{{layout-cell}} 274 +{{panel borderStyle="solid" title="Search all Documentation:"}} 270 270 271 -Let's assume I have a page where the first article is displayed when the page loads and three mores articles are displayed as the user scrolls down. The first article will be tracked by ONEcount, but for the three other articles, a call to GCN.onecount.track needs to be made to tell ONEcount that the articles have been displayed. The url should be the direct url of the article. The referrer should be the previous article's url. 272 272 273 -=== GCN.onecount.gate(resourceId, callback): === 277 +{{livesearch/}} 278 +{{/panel}} 274 274 275 - Gating is currentlydonebasedon a REGEX match of a url segmenton pageload. Thisfunctionisdesignedto allow customersto gatecontent wheregating can not besufficientlymanagedusing URL segments,orwhere contentmust be gated without a page load.280 +{{panel borderStyle="solid" title=" Search System and Setup Information:"}} 276 276 277 -This function expects **two parameter** : 278 278 279 - 1. **resourceId** : thisisthe**resourceId**thatwill beusedforgating and it's **required.**280 - 1. **callback:** this is a function that can bepassed. The responsefrom the gating request will be made available in the callback. The callback should expect one parameter which is a JSON object. The JSON object has a property called hasAccess which is a boolean (true/false). **true** means the user has access and **false** means he does not.283 +{{pagetreesearch rootPage="System and Setup Information"/}} 284 +{{/panel}} 281 281 282 -Resource Ids are available in ONEcount on the resource listing page. 286 +{{panel borderStyle="solid" title="More System and Setup Information"}} 287 +{{expand}} 288 +[[ONEcount Cookies>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65727||shape="rect"]] 289 +\\[[Widget Implementation>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65622||shape="rect"]] 290 +\\[[Widget Builder>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]] 291 +\\[[\\\\ONEcount Javascript Widget Changes>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65751||shape="rect"]][[ 292 +\\>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[Configuration Manager>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65754||shape="rect"]][[ 293 +\\>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[Smartlinks, Brand Codes, and Other Form Linkouts>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65829||shape="rect"]][[ 294 +>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[ 295 +ONEcount SSL and non-SSL Client Brand Pages>>url:http://bos-jira01-cl01.onecount.net:8090/display/OD/ONEcount+SSL+and+non-SSL+Client+Brand+Pages||shape="rect"]][[ 296 +\\>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[OpenX Zone Setup for Banner Tracking and Viewability>>url:http://bos-jira01-cl01.onecount.net:8090/display/OD/OpenX+Zone+Setup+for+Banner+Tracking+and+Viewability||shape="rect"]][[ 297 +\\>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[DFP Small Business – Create Key/Value Pair for Ad Targeting>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65873||shape="rect"]][[ 298 +\\>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[DFP Premium – Create Key/Value Pair for Ad Targeting>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65879||shape="rect"]][[ 299 +\\>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[Progressive Lookup>>url:http://bos-jira01-cl01.onecount.net:8090/display/OD/Progressive+Lookup||shape="rect"]][[ 300 +\\>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[Embedding Forms in Web Pages>>url:http://bos-jira01-cl01.onecount.net:8090/display/OD/Embedding+Forms+in+Web+Pages||shape="rect"]][[ 301 +\\>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[Overriding Lookup/Login Page Settings>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65896||shape="rect"]][[ 302 +>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[ 303 +Email Engine and Sender Score>>url:http://bos-jira01-cl01.onecount.net:8090/display/OD/Email+Engine+and+Sender+Score||shape="rect"]][[ 304 +\\>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[Global Features>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65905||shape="rect"]][[ 305 +>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[ 306 +>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65751||shape="rect"]][[ 307 +>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65751||shape="rect"]] 308 +{{/expand}} 309 +{{/panel}} 283 283 284 - Tocreate a resource that uses this function, choose “Function” from the resource type pull-down, then enter a text return value in the box below. This return value is ignored for now, but may be used to trigger gating in the future.311 + 285 285 286 - Whenthe function is called and the user is not subscribed to the product that the resource belongs to, he will be taken to the registration page in order to do so. If he is already subscribed to the product then nothing will happen.313 + 287 287 288 - 289 - 290 -**__NOTE:__** If page load speed is ever a concern, it is recommended to use a third party service (such as tools.pingdom.com). By doing so, it will generate report of all items loading on your webpage along with their load times. Simply copy and paste your page's URL into the designated field and a test will be conducted immediately. If any** oc.net** item exceeds a load speed of 500ms, please enter a Helpdesk ticket for us to review. Testing page load speeds is a very informative way of identifying items that are directly impacting page performance. It is worth mentioning that there will be items that continuously load in short spurts (ex. **v.js** for viewability data) however those short spurts do not negatively impact load speed performance. 291 - 292 - 293 293 294 294 {{/layout-cell}} 295 295 {{/layout-section}}
- Confluence.Code.ConfluencePageClass[0]
-
- id
-
... ... @@ -1,1 +1,1 @@ 1 - 661311 +50528279 - url
-
... ... @@ -1,1 +1,1 @@ 1 -https://info.onecount.net//wiki/spaces/OD/pages/ 66131/ONEcount Javascript Widgets1 +https://info.onecount.net//wiki/spaces/OD/pages/50528279/ONEcount Javascript Widgets