Changes for page Widget Implementation -- oc.min.js
Last modified by Admin User on 2025/06/27 12:15
From version 33.1
edited by Admin
on 2022/05/13 11:43
on 2022/05/13 11:43
Change comment:
There is no comment for this version
To version 41.1
edited by Admin User
on 2024/10/28 16:53
on 2024/10/28 16:53
Change comment:
There is no comment for this version
Summary
-
Page properties (4 modified, 0 added, 0 removed)
-
Objects (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Title
-
... ... @@ -1,1 +1,1 @@ 1 -Widget Implementation 1 +Widget Implementation -- oc.min.js - Parent
-
... ... @@ -1,0 +1,1 @@ 1 +System Setup Detail and Technical Information - Author
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. Admin1 +XWiki.admin - Content
-
... ... @@ -1,12 +1,10 @@ 1 1 {{layout}} 2 2 {{layout-section ac:type="two_right_sidebar"}} 3 3 {{layout-cell}} 4 - 5 - 6 6 {{id name="Start ScreenSteps Content"/}} 7 -(% style="color: rgb(128,128,128);" %)// In order to identify users and track activity, widgets must be embedded on every page of your web site .//5 +(% style="color:#808080" %)// In order to identify users and track activity, widgets must be embedded on every page of your web site .// 8 8 9 -(% style="color: rgb(128,128,128);" %)//These widgets, specific to your site(s), and directions for placement are provided in the Widget Builder.//7 +(% style="color:#808080" %)//These widgets, specific to your site(s), and directions for placement are provided in the Widget Builder.// 10 10 11 11 === ONEcount Library/Tracker === 12 12 ... ... @@ -14,30 +14,34 @@ 14 14 15 15 Access protection: Pages or sections of pages that are defined as a resource in ONEcount and that require registration/ signup are handled by this widget. If a resource is being accessed and the user that is trying to access it is not logged in or doesn't have access to that particular resource, then they will be directed to the lookup/ login page (or if lookup/login is set to "off", to the registration form enabled with progressive lookup functionality) where they can log in or complete registration. 16 16 17 -This widget also allows users who have clicked on a smartlink(% style="color: rgb(255,0,0);" %)*(%%) to automatically be logged in to ONEcount, as well as users identified by a ONEcount cookie-sync with other third-party identification systems you may use. In either case, ONEcount will identify the user and set a cookie for her/him. Any subsequent action by that user on the site will then be tracked and attributed to that user (via tracking widget). These users are included in statistics for Known Users. Note that if a user goes directly to the website (not directed there by a smartlink) and is NOT logged in, he/she will NOT be identified and tracked as a Known User. A user must be logged in to be identified.15 +This widget also allows users who have clicked on a smartlink(% style="color:#ff0000" %)*(%%) to automatically be logged in to ONEcount, as well as users identified by a ONEcount cookie-sync with other third-party identification systems you may use. In either case, ONEcount will identify the user and set a cookie for her/him. Any subsequent action by that user on the site will then be tracked and attributed to that user (via tracking widget). These users are included in statistics for Known Users. Note that if a user goes directly to the website (not directed there by a smartlink) and is NOT logged in, he/she will NOT be identified and tracked as a Known User. A user must be logged in to be identified. 18 18 19 19 This widget also tracks all web activity. 20 20 21 21 ==== ONEcount Library/Tracker Placement: ==== 22 22 23 -The main ONEcount widget, ( all.min.js) is responsible for loading most of the code that ONEcount uses when a user visits your web site. It also takes the first step in identifying visitors to your web site, so it’s important it be placed properly on the site.21 +The main ONEcount widget, (oc.min.js) is responsible for loading most of the code that ONEcount uses when a user visits your web site. It also takes the first step in identifying visitors to your web site, so it’s important it be placed properly on the site. 24 24 25 -Tag management platforms can be used as long as you can control where the ONEcount widget loads. Because order and placement is often difficult for users to configure, we recommend placing the ONEcount widget directly on the page. 23 +Tag management platforms can be used as long as you can control where the ONEcount widget loads. Because order and placement is often difficult for users to configure, we recommend placing the ONEcount widget directly on the page, as the first element in the document <HEAD>. For further reading on fun with Google Tag Manager, read [[here.>>url:https://www.simoahava.com/gtm-tips/gtm-container-snippet-in-the-head/||shape="rect"]] 26 26 27 -ONEcount uses first-party cookies to track user behavior and target users. There are two main cookies that are important here: the OCID cookie, which identifies a user who exists as a user in the ONEcount database (ie., a “known” user), and the tmp -cookie, which is a tracking cookie assigned to all users, known and unknown. If a user has a tmp-cookie in their browser, ONEcount can track and target the user. If the user also has an OCID cookie in their browser, ONEcount can match that browser to a record in your database.25 +ONEcount uses first-party cookies to track user behavior and target users. There are two main cookies that are important here: the OCID cookie, which identifies a user who exists as a user in the ONEcount database (ie., a “known” user), and the tmpcookie, which is a tracking cookie assigned to all users, known and unknown. If a user has a tmpcookie in their browser, ONEcount can track and target the user. If the user also has an OCID cookie in their browser, ONEcount can match that browser to a record in your database. 28 28 29 29 These cookies exist in two domains: the “local” domain for your web site or one of your web sites, and the “central” domain ([[onecount.net>>url:http://onecount.net||shape="rect"]]). ONEcount is designed for multi-site identification; a user who logs in on your Site A, can also be logged in on your Site B via the central domain cookie. 30 30 31 -When the page loads, the ONEcount widget checks the local domain for the tmp 29 +When the page loads, the ONEcount widget checks the local domain for the tmpcookie. If the user is visiting your site for the first time, he or she may not have a local domain tmpcookie. The ONEcount widget then checks the ONEcount central domain ([[onecount.net>>url:http://onecount.net||shape="rect"]]) to see if the user has a first-party tmpcookie in that domain. If there is a tmpcookie in the central domain, the ONEcount widget reloads the page and sets a tmpcookie in the local domain. When a user is identified through a registration, cookie-sync or link-click, the OCID cookie is created in both the local and central domains during the subsequent page load. 32 32 33 33 ~*~*Please note that these central domain cookies are //customer-specific//, and we do not share those cookies between customers. 34 34 35 35 The main ONEcount widget is as follows: 36 36 37 -<script id="oc-widget-main" src="https:~/~/validate.onecount.net/js/ all.min.js#%%%%%%%%%%%%%%%%"></script>35 +<script id="oc-widget-main" src="https:~/~/validate.onecount.net/js/oc.min.js#%%%%%%%%%%%%%%%%"></script> 38 38 39 - Itincludesaunique customer identifierthat willbeuniqueyour installationfONEcount.Youshould place thewidgetinheheader oftheroottemplateofyourwebsite(s)soitcanloadoneverypageyouwouldlikeONEcount to track.37 +Most US-based customers will get the fastest response downloading the widget from our data centers in New Jersey and Illinois using the URL above. Customers with a presence outside the United States may experience lower latency by downloading the main ONEcount widget from our global CDN. To do that, simply substitute the hostname "cdn.onecount.net" for "validate.onecount.net in the URL above. As illustrated here: 40 40 39 +<script id="oc-widget-main" src="https:~/~/cdn.onecount.net/js/oc.min.js#%%%%%%%%%%%%%%%%"></script> 40 + 41 +The widget includes a unique customer identifier that will be unique to your installation of ONEcount. You should place the widget in the header of the root template of your web site(s) so it can load on every page you would like ONEcount to track. 42 + 41 41 The main widget should be placed in the document header, after the Title and Meta Keywords tags so that these values can be available to the ONEcount widget when a user visits a page. 42 42 43 43 If you are using any third-party tracking or measuring pixels (ie., Google Analytics, Adobe, etc.), you should place these pixels after the ONEcount pixel. ... ... @@ -46,6 +46,9 @@ 46 46 47 47 In other words, the following order: 48 48 51 +<HTML> 52 +<HEAD> 53 +<TITLE>title</TITLE> 49 49 Google Analytics Widget 50 50 ONEcount Widget 51 51 ... ... @@ -53,27 +53,37 @@ 53 53 54 54 This order: 55 55 61 +<HTML> 62 +<HEAD> 63 +<TITLE>title</TITLE> 56 56 ONEcount Widget 57 57 Google Analytics Widget 58 58 59 59 Will allow ONEcount to reload the page for first-time visitors prior to the GA widget loading, resulting in a single impression. 60 60 61 - Oncethe widget is placed onyourpages,you will see anumberof pixels loadfrom the [[onecount.net>>url:http://onecount.net||shape="rect"]]domain eachtime the page loads.Mostof these pixels load asynchronously,meaninginparalle, andshouldnotmpact your page load at all.69 +If you're concerned about how the page reload impacts user experience, keep in mind two things: 62 62 63 - \\71 +1) The redirect only happens once per user, per device. 64 64 65 - (% style="color: rgb(255,0,0);"%)//*****//(%style="color:rgb(0,0,0);" %)//A smartlinkisanylink thathasparameters for identifyingthe userappendedtothedoftheURL. These parametersvarybasedontheemailmarketingplatform you use(e.g.ONEcount'sintegratedEmail Engine, Real Magnet/MagnetMail,Exact Target, Silverpop,etc.)Upon clickingon a smartlink,twothings will happen: 1) the user will be authenticated automaticallyfor access-controlled content;and2)the userwill beidentified inthesystem as a ONEcountuser and a cookie willbeset, allowing youto track as a Known userall activities across your onlineproperties. //(%%)//*See Smartlinks andOther Form Linkouts// //documentation for more information on smartlinks.//73 +2) If the widget is placed properly, the user won't experience the redirect. As you can see from the placement above, the ONEcount widget is delivered prior to any content, so the user experience won't be interrupted. 66 66 67 - \\75 +3) The redirect is required in order to get around Apple's Intelligent Tracking Protection software, which limits the life-span of even first-party cookies that are set in Javascript. During the redirect, ONEcount's first-party cookies are set by the server, making them immune to ITP. For more info on this issue, click [[here.>>url:https://cookiesaver.io/archives/analytics-guides/how-safari-itp-impacts-cookies/||shape="rect"]] 68 68 69 - ===AutomationWidget===77 +Once the widget is placed on your pages, you will see a number of pixels load from the [[onecount.net>>url:http://onecount.net||shape="rect"]] domain each time the page loads. Most of these pixels load asynchronously, meaning in parallel, and should not impact your page load at all. 70 70 71 - Automation scripts aresofjavascriptcode thatallowONEcount to target actions(like adtarget, popuptargetetc).This piece ofjavascript determines andoutputs anyautomatedactionto thebrowser.79 +(% style="color:#ff0000" %)//*//(% style="color:#000000" %)//A smartlink is any link that has parameters for identifying the user appended to the end of the URL. These parameters vary based on the email marketing platform you use (e.g. ONEcount's integrated Email Engine, Real Magnet/Magnet Mail, Exact Target, Silverpop, etc.) Upon clicking on a smartlink, two things will happen: 1) the user will be authenticated automatically for access-controlled content; and 2) the user will be identified in the system as a ONEcount user and a cookie will be set, allowing you to track as a Known user all activities across your online properties. //(%%)//*See Smartlinks and Other Form Linkouts// //documentation for more information on smartlinks.// 72 72 73 -This snippet is placed inside head (<head></head>) and SHOULD BE PLACED AFTER any ad network slot definition code (DFP). 74 74 75 -Se eWidgetBulderdocumentationformoreinformation.82 +=== NO LONGER USED: The following widget is no longer needed, 05/15/2022 === 76 76 84 +=== --Automation Widget-- === 85 + 86 +--Automation scripts are snippets of javascript code that allow ONEcount to target actions (like ad target, popup target etc). This piece of javascript determines and outputs any automated action to the browser.-- 87 + 88 +--This snippet is placed inside head (<head></head>) and SHOULD BE PLACED AFTER any ad network slot definition code (DFP).-- 89 + 90 +--See Widget Bulder documentation for more information.-- 91 + 77 77 === IVT Tracker and Noscript Tag === 78 78 79 79 _**The IVT tracker snippet identifies potential IVT traffic, and the noscript tag is needed to track requests when javascript is disabled.** _ ... ... @@ -108,7 +108,6 @@ 108 108 109 109 ONEcount will accept three different properties: keywords, og:keywords, and oc:keywords. 110 110 111 -\\ 112 112 113 113 114 114 ... ... @@ -116,59 +116,40 @@ 116 116 {{/layout-cell}} 117 117 118 118 {{layout-cell}} 119 - \\133 + 120 120 121 - \\135 +{{panel borderStyle="solid" title=""}}{{/panel}} 122 122 123 -{{panel borderStyle="solid" title=" Searchall Documentation:"}}137 +{{panel borderStyle="solid" title=" "}}{{/panel}} 124 124 125 - 126 -{{livesearch/}} 127 -{{/panel}} 128 - 129 -{{panel borderStyle="solid" title=" Search System and Setup Information:"}} 130 - 131 - 132 -{{pagetreesearch rootPage="System and Setup Information"/}} 133 -{{/panel}} 134 - 135 135 {{panel title="On this page:"}} 136 - 137 - 138 138 {{toc style="square"/}} 139 139 {{/panel}} 140 140 141 141 {{panel borderStyle="solid" title="More System and Setup Information"}} 142 -{{expand}} 144 +{{expand title="Click here to expand..."}} 143 143 [[ONEcount Cookies>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65727||shape="rect"]] 144 144 \\[[Widget Implementation>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65622||shape="rect"]] 145 145 \\[[Widget Builder>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]] 146 -\\[[doc:ONEcount Javascript Widgets]][[ 147 -\\ONEcount Javascript Widget Changes>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65751||shape="rect"]][[ 148 -\\>>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"]][[ 149 -\\>>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"]][[ 150 ->>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[ 151 -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"]][[ 152 -\\>>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"]][[ 153 -\\>>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"]][[ 154 -\\>>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"]][[ 155 -\\>>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"]][[ 156 -\\>>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"]][[ 157 -\\>>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"]][[ 158 ->>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[ 159 -Email Engine and Sender Score>>url:http://bos-jira01-cl01.onecount.net:8090/display/OD/Email+Engine+and+Sender+Score||shape="rect"]][[ 160 -\\>>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"]][[ 161 ->>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[ 162 ->>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65751||shape="rect"]][[ 163 ->>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65751||shape="rect"]] 148 +\\[[doc:ONEcount Javascript Widgets]] 149 +\\[[ONEcount Javascript Widget Changes>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65751||shape="rect"]] 150 +\\[[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735]][[Configuration Manager>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65754||shape="rect"]] 151 +\\[[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735]][[Smartlinks, Brand Codes, and Other Form Linkouts>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65829||shape="rect"]][[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]] 152 +[[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"]] 153 +\\[[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735]][[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"]] 154 +\\[[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735]][[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"]] 155 +\\[[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735]][[DFP Premium – Create Key/Value Pair for Ad Targeting>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65879||shape="rect"]] 156 +\\[[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735]][[Progressive Lookup>>url:http://bos-jira01-cl01.onecount.net:8090/display/OD/Progressive+Lookup||shape="rect"]] 157 +\\[[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735]][[Embedding Forms in Web Pages>>url:http://bos-jira01-cl01.onecount.net:8090/display/OD/Embedding+Forms+in+Web+Pages||shape="rect"]] 158 +\\[[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735]][[Overriding Lookup/Login Page Settings>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65896||shape="rect"]][[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]] 159 +[[Email Engine and Sender Score>>url:http://bos-jira01-cl01.onecount.net:8090/display/OD/Email+Engine+and+Sender+Score||shape="rect"]] 160 +\\[[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735]][[Global Features>>url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65905||shape="rect"]][[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65735||shape="rect"]][[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65751||shape="rect"]][[url:http://bos-jira01-cl01.onecount.net:8090/pages/viewpage.action?pageId=65751||shape="rect"]] 164 164 {{/expand}} 165 165 {{/panel}} 166 166 167 -\\ 168 168 169 -\\ 170 170 171 - \\166 + 172 172 {{/layout-cell}} 173 173 {{/layout-section}} 174 174 {{/layout}}
- Confluence.Code.ConfluencePageClass[0]
-
- id
-
... ... @@ -1,1 +1,1 @@ 1 -6 67158081 +65622 - url
-
... ... @@ -1,1 +1,1 @@ 1 -https://info.onecount.net//wiki/spaces/OD/pages/6 6715808/Widget Implementation1 +https://info.onecount.net//wiki/spaces/OD/pages/65622/Widget Implementation -- all.min.js