View source for DCR Czech Static Browser SDK

{{Breadcrumb|}} {{Breadcrumb|Digital}} {{Breadcrumb|International}}  {{CurrentBreadcrumb}}
[[Category:Digital]]

This guide will show you how to enable page measurement (aka Static) on your website(s). The Nielsen Tracking Code must be added to each page with different metadata.

== Prerequisites ==
To get started, an App ID is needed. The App ID is a unique ID assigned to the player/site/app. This will be provided upon starting the integration. If not, please contact Nielsen local staff - see [[Czech Contacts]].<br />

<syntaxhighlight lang="html">
apid: "PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
</syntaxhighlight>
<br />

== Step 1:  Add Static Queue Snippet ==
The static queue snippet allows the SDK APIs to be called while the actual SDK and configuration file are still being downloaded. As the queue can capture all API calls before the download completes, there is no wait time. Once the SDK is available, the API calls will transition from directing to the queue to the SDK seamlessly.<br />

<syntaxhighlight lang="javascript">
!function(t,n){t[n]=t[n]||
{
  nlsQ:function(e,o,c,r,s,i)
    {
      return s=t.document,
      r=s.createElement("script"),
      r.async=1,
      r.src=("http:"===t.location.protocol?"http:":"https:")+"//cdn-gl.imrworldwide.com/conf/"+e+".js#name="+o+"&ns="+n,i=s.getElementsByTagName("script")[0],i.parentNode.insertBefore(r,i),
      t[o]=t[o]||{g:c,ggPM:function(n,e,c,r,s){(t[o].q=t[o].q||[]).push([n,e,c,r,s])}},t[o]}
    }
}
(window,"NOLBUNDLE");
</syntaxhighlight>

== Step 2: Create SDK Instance ==
While creating an SDK instance, initialize the SDK by calling:

<syntaxhighlight lang="javascript">
  // SDK Initialization
  var nSdkInstance = NOLBUNDLE.nlsQ("PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX","nlsnInstance", {nol_sdkDebug: "debug"});
</syntaxhighlight>
<br />

The initialization call has the below parameters:
{| class="wikitable"
|-
! Parameter	!! Description	!! Required !! Values
|-
| apid	|| Unique ID assigned to player/site ||Yes	||'PXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX'
|-
|instanceName ||	Name of SDK instance||Yes	 ||	"any string value"
|-
| nol_sdkDebug	|| Enables Nielsen console logging. Only required for testing	||No	|| "{nol_sdkDebug: "debug"})"
|}


When the initialization call is made, a unique static config file, <code><apid>.js</code>, will be downloaded based on the <code>apid</code> and cached by the client-side browser(s).

Once the static config file is downloaded, the SDK will be fully downloaded and initialized. All SDK modules are included in one file:
"nlsSDK600.bundle.min.js".

== Step 3: Create Metadata Object ==

<syntaxhighlight lang="javascript">
  // Content Metadata
  var nielsenMetadata = {
    type: 'static',
    assetid: '', // *DYNAMIC METADATA*: unique ID for each article **REQUIRED**
    section: '', // *DYNAMIC METADATA*: section of site **REQUIRED**
    segA: '', // *DYNAMIC METADATA*: custom segment
    segB: '', // *DYNAMIC METADATA*: custom segment
    segC: ''  // *DYNAMIC METADATA*: custom segment
    };
</syntaxhighlight><br />

Metadata can be passed through key-values using the Nielsen reserved keys.
See [[Czech Metadata]].
<br />

'''Aggregation Limits'''
There are limits on the number of unique values that can be aggregated on in reporting. The specific limitations by key are:
{| class="wikitable"
|-
! Key !! Aggregation Limit
|-
| section || maximum of 25 unique values (section <= 25)
|-
| segA || Maximum number of unique values allowed across segA, segB, and segC is 25 (segA + segB + segC<= 25)
|-
| segB || Maximum number of unique values allowed across segA, segB, and segC is 25 (segA + segB + segC<= 25)
|-
| segC || Maximum number of unique values allowed across segA, segB, and segC is 25 (segA + segB + segC<= 25)
|}
So for example, if your site has 30 sections (e.g. News, Sports, Videos, Music, etc.), we would only measure for the first 25 sections. The same applies to the custom breakout parameters segA/B/C.

== Step 4: Call staticstart Event ==
Start static measurement :
<syntaxhighlight lang="javascript">
  // Event 'staticstart' Call
  nSdkInstance.ggPM("staticstart", nielsenMetadata);
</syntaxhighlight>

The content metadata object is passed as a parameter.


== Step 5: Call staticend Event ==
Stop static measurement = to end the current static session and track a new static content:
<syntaxhighlight lang="javascript">
  // Event 'staticend' Call
  nSdkInstance.ggPM("staticendt", nielsenMetadata);
</syntaxhighlight>

The content metadata object is passed as a parameter. <br />
Recommendation : Do not place this call inside onBeforeUnload method, because SDK need some time and resources to deliver data to cloud.

== Step 6 : Nielsen Opt-Out ==
The site must provide a means for the user to opt-out of, or opt back into Nielsen Measurement. A user can opt-out if they would prefer not to participate in any Nielsen online measurement research. To implement the opt-out option, include the following two items in your privacy policy.
*A notice that the player includes proprietary measurement software that allows users to contribute to market research (such as Nielsen TV Ratings).
*A link to the Nielsen Digital Measurement Privacy Policy

On the Nielsen Digital Measurement Privacy Policy page, users can click Choices to read more detailed information about the measurement software, learn about their options with regard to Nielsen measurement, and, if they do not want to participate in Nielsen online measurement, click a link to receive an opt-out cookie. Once users have opted-out, they can choose to opt back into Nielsen Measurement at anytime by selecting the opt back in link on the Nielsen Digital Privacy Policy page. When a user selects the link, their opt-out cookie will be deleted and they will be able to be measured.

The following paragraph is a template for an opt-out statement (in Czech).
<blockquote>
Tato aplikace obsahuje proprietární měřicí software společnosti Nielsen, který uživatelům umožní přispívat k průzkumu trhu. Chcete-li se dozvědět více o informacích, které může software Nielsen shromažďovat a o Vaší možnosti měření deaktivovat, přečtěte si zásady ochrany osobních údajů Nielsen Digital Measurement na <a href=http://cdn-gl.imrworldwide.com/priv/browser/cz/cs/optout.html>Nielsen Digital Measurement Privacy Policy</a>
</blockquote>

=== Opt-out status ===
Optional : to retrieve Opt-Out status call getOptOutStatus() , result is boolean value true (OptOuted = not measuring) or false (not OptOuted = measuring).
<syntaxhighlight lang="javascript">
nSdkInstance.getOptOutStatus();
</syntaxhighlight>

== Step 7 : Test your player by your self ==

see how to test player at https://www.youtube.com/watch?v=t9eUsf9yh8w&feature=youtu.be

=== Test SKD API calls ===
to verify SDK API calls use Chrome and install add-on called "Nielsen SDK Inspector" (https://chrome.google.com/webstore/search/%20Nielsen%20SDK%20Inspector)<br />


=== Test outgoing pings ===
to verify outgoing pings use Charles Proxy or any other proxy sw capable to sniff your network traffic. Filter URLs to "imrworld".
Example of such ping :

<code><nowiki>http://secure-eu-cert.imrworldwide.com</nowiki>/cgi-bin/gn?prd=dcr<wbr />&ci=de-205177<wbr />&ch=de-205177_c01_static-123_P<wbr />&asn=static-123<wbr />&sessionId=b45a84a8-7847-4b2d-8cec-36baad20ed29<wbr />&prv=1<wbr />&c6=vc,c01<wbr />&ca=NA<wbr />&c13=asid,T74896328-A13B-4985-8798-0AEBFA228D3E<wbr />&c32=segA,segA%20example<wbr />&c33=segB,segB%20example<wbr />&c34=segC,segC%20example<wbr />&c15=apn,<wbr />&sup=1<wbr />&segment2=<wbr />&segment1=<wbr />&forward=0<wbr />&ad=0<wbr />&cr=V<wbr />&c9=devid,<wbr />&enc=true<wbr />&c1=nuid,2ccec3b2-36a5-4eeb-a408-4d6eec7e1083<wbr />&at=view<wbr />&rt=text<wbr />&c16=sdkv,bj.6.0.0<wbr />&c27=cln,0<wbr />&crs=<wbr />&lat=<wbr />&lon=<wbr />&c29=plid,14991647575861178<wbr />&c30=bldv,6.0.0.15<wbr />&st=dcr<wbr />&c7=osgrp,<wbr />&c8=devgrp,<wbr />&c10=plt,<wbr />&c40=adbid,<wbr />&c14=osver,NA<wbr />&c26=dmap,1<wbr />&dd=<wbr />&hrd=<wbr />&wkd=<wbr />&c35=adrsid,<wbr />&c36=cref1,<wbr />&c37=cref2,<wbr />&c11=agg,1<wbr />&c12=apv,<wbr />&c51=adl,0<wbr />&c52=noad,0<wbr />&devtypid=<wbr />&pc=NA<wbr />&c53=fef,n<wbr />&c54=oad,<wbr />&c55=cref3,<wbr />&c57=adldf,2<wbr />&ai=static-123<wbr />&c3=st,c<wbr />&c64=starttm,1499164759<wbr />&adid=static-123<wbr />&c58=isLive,false<wbr />&c59=sesid,<wbr />&c61=createtm,1499164772<wbr />&c63=pipMode,<wbr />&c68=bndlid,<wbr />&nodeTM=<wbr />&logTM=<wbr />&c73=phtype,<wbr />&c74=dvcnm,<wbr />&c76=adbsnid,<wbr />&df=0<wbr />&c44=progen,<wbr />&davty=0<wbr />&si=http%3A%2F%2Fsdkdemo.admosphere.cz%2FBrowserSdk6static%2Fdemo1cz%2F<wbr />&c66=mediaurl,<wbr />&c62=sendTime,1499164772<wbr />&rnd=397839</code>

== Step 8 : Provide your app for certification ==
Once ready please send your application to Nielsen local staff for verification - see [[Czech Contacts]].

== Step 9 : Going Live ==
After the integration has been certified (but not prior that), users will need to disable debug logging by deleting {nol_sdkDebug: 'DEBUG'} from initialization call - see Step 2.

== Demos ==
see live demos with sample implementation available at at http://sdkdemo.admosphere.cz/