Skip to Content
Last modified by Admin User on 2025/06/27 12:15
From version 33.1
edited by Admin
on 2022/05/13 11:43
Change comment: There is no comment for this version
To version 29.1
edited by steven@one-count_com
on 2018/07/10 17:47
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.Admin
1 +XWiki.steven@one-count_com
Content
... ... @@ -14,58 +14,14 @@
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.
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. The system 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 -==== ONEcount Library/Tracker Placement: ====
21 +This widget must be embedded inside the head section(<head></head>) of the website and should be placed BEFORE any other third party trackers (like Google analytics) or ad network codes and AFTER the title meta tag.
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.
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.
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.
28 -
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 -
31 -When the page loads, the ONEcount widget checks the local domain for the tmp cookie. If the user is visiting your site for the first time, he or she may not have a local domain tmp cookie. The ONEcount widget then check the ONEcount central domain ([[onecount.net>>url:http://onecount.net||shape="rect"]]) to see if the user has a first-party tmp cookie in that domain. If there is a tmp cookie in the central domain, the ONEcount widget reloads the page and sets a tmp cookie 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.
32 -
33 -~*~*Please note that these central domain cookies are //customer-specific//, and we do not share those cookies between customers.
34 -
35 -The main ONEcount widget is as follows:
36 -
37 -<script id="oc-widget-main" src="https:~/~/validate.onecount.net/js/all.min.js#%%%%%%%%%%%%%%%%"></script>
38 -
39 -It 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.
40 -
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 -
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.
44 -
45 -This is to avoid double-counting page views from first time visitors.
46 -
47 -In other words, the following order:
48 -
49 -Google Analytics Widget
50 -ONEcount Widget
51 -
52 -Would result in Google Analytics recording two page impressions for a first-time site visitor, because GA would count the initial load, and then record an additional page load after the redirect.
53 -
54 -This order:
55 -
56 -ONEcount Widget
57 -Google Analytics Widget
58 -
59 -Will allow ONEcount to reload the page for first-time visitors prior to the GA widget loading, resulting in a single impression.
60 -
61 -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 paralle, and should not impact your page load at all.
62 -
63 -\\
64 -
65 65  (% style="color: rgb(255,0,0);" %)//*****//(% style="color: rgb(0,0,0);" %)//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.//
66 66  
67 -\\
68 -
69 69  === Automation Widget ===
70 70  
71 71  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.
... ... @@ -84,41 +84,33 @@
84 84  
85 85  === Banner Trackers ===
86 86  
87 -Banner widgets are used to track and report banner activity. The banner widgets also track whether banner ads are "in view" on the user's screen. This is accomplished by a specific pixel that "checks-in" with ONEcount every three seconds to report whether the banner is still in view. This URL (v_js.php) may appear in the lower-left of your browser screen each time it is called, making it appear that v_js.php is loading and potentially slowing down the loading of the web page. This is not the case. If you view the load time in the developer tools of your browser, you will see this pixel is firing repeatedly, usually taking less than 10ms. Also, this pixel fires asynchronously, meaning in parallel with other elements on the page. So there is no impact on site performance from this pixel.
43 +Banner widgets are used to track and report banner activity.
88 88  
89 89  There are two banner platforms supported within ONEcount: OpenX and DFP (Premium and Small Business).
90 90  
91 91  Widget Builder documentation provides widgets and directions for both platforms.
92 92  
93 -=== ONEcount Pixel for Moat ===
49 +=== Third Party Trackers Modifications ===
94 94  
95 -ONEcount can collect ad viewability data from Moat's realtime pixel. In order to send data to ONEcount, Moat can fire a pixel like like that in the Widget Builder to send data to ONEcount.
51 +Usually websites will have third party trackers like Google Analytics, etc. installed on their website. A small piece of code needs to be added to those third party trackers so that ONEcount can pass the original referrer to those systems.
96 96  
97 -=== Content Meta Tags ===
53 +We provide the code that needs to be added to your Google analytics code. See Widget Builder documenation.
98 98  
99 -ONEcount uses content meta tags from your web pages to determine the type of content users are consuming. In order for ONEcount to understand the engagement users are having on your site, you should configure specific keywords in the meta tags in your web pages that represent what the content is about.
55 +If any other third party trackers are being used on your website, please let your ONEcount account manager know ahead of time.
100 100  
101 -For example, if you have an article about swimming pools, you might use keywords like "pool," "swimming," "water," etc.
57 +=== ONEcount Pixel for Moat ===
102 102  
103 -There are three ways to tell ONEcount what type of content is on your web page:
59 +ONEcount can collect ad viewability data from Moat's realtime pixel. In order to send data to ONEcount, Moat can fire a pixel like like that in the Widget Builder to send data to ONEcount.
104 104  
105 -<meta name="oc:keywords" content="swimming,pool,swimming pool,water" />
106 106  
107 -<meta property="oc:keywords" content="swimming,pool,swimming pool,water" />
108 108  
109 -ONEcount will accept three different properties: keywords, og:keywords, and oc:keywords.
110 -
111 -\\
112 -
113 -
114 -
115 115  {{id name="End ScreenSteps Content"/}}
116 116  {{/layout-cell}}
117 117  
118 118  {{layout-cell}}
119 -\\
67 +
120 120  
121 -\\
69 +
122 122  
123 123  {{panel borderStyle="solid" title="Search all Documentation:"}}
124 124  
... ... @@ -164,11 +164,11 @@
164 164  {{/expand}}
165 165  {{/panel}}
166 166  
167 -\\
115 +
168 168  
169 -\\
117 +
170 170  
171 -\\
119 +
172 172  {{/layout-cell}}
173 173  {{/layout-section}}
174 174  {{/layout}}
Confluence.Code.ConfluencePageClass[0]
id
... ... @@ -1,1 +1,1 @@
1 -66715808
1 +36667493
url
... ... @@ -1,1 +1,1 @@
1 -https://info.onecount.net//wiki/spaces/OD/pages/66715808/Widget Implementation
1 +https://info.onecount.net//wiki/spaces/OD/pages/36667493/Widget Implementation