View source for DCR Italy Static Facebook Instant Articles Browser SDK

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

This guide will show you how to enable Digital Content Ratings (DCR) measurement on your Facebook Instant Articles.

== Implementation Steps ==
=== Add Tracking Code ===
DCR measurement can be added to your Instant Articles through the Analytics element:
<syntaxhighlight lang="html"><figure class="op-tracker">
    <iframe>
        <!-- Add Nielsen DCR Tracking Code here -->
    </iframe>
</figure></syntaxhighlight>

For more information on the Analytics element, you can refer to the [https://developers.facebook.com/docs/instant-articles/analytics/overview Insights and Analytics in Instant Articles] section of Facebook’s Instant Article Developer Documentation.


The Nielsen DCR Tracking code below will need to be added within the <code><iframe></code> of the Analytics element on each article:
<syntaxhighlight lang="html">
<script>
  // Static Queue Snippet
!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[n][o]=t[n][o]||{g:c||{},ggPM:function(e,c,r,s,i){(t[n][o].q=t[n][o].q||[]).push([e,c,r,s,i])}},t[n][o]}}}(window,"NOLBUNDLE");

  // SDK Initialization
  var nSdkInstance = NOLBUNDLE.nlsQ("PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX","nlsnInstance", {nsdkvOverride: "501", nol_sdkDebug: "debug"});
  
  // Content Metadata 
  var nielsenMetadata = {
    type: 'static', 
    assetid: '', // *DYNAMIC METADATA*: unique ID for each article **REQUIRED**
    section: '', // *DYNAMIC METADATA*: section of site **REQUIRED**
    segC: 'Instant Articles' 
    }; 
    
  // Event 'staticstart' Call
  nSdkInstance.ggPM("staticstart", nielsenMetadata);
</script></syntaxhighlight>


=== Configure Metadata ===
Metadata can be passed through key-values using the Nielsen reserved keys. The tracking code includes the Nielsen reserved keys and placeholder values, <code><metadataPlaceholder></code>, for dynamic metadata. You will need to update these values.


====Metadata Keys====
The Nielsen reserved keys are:
{| class="wikitable"
|-
! Key !! Description !! Example Value !! Required
|-
| apid || unique ID assigned by Nielsen || <code>XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX</code> || ✓
|-
| section || section of the site to be measured || <code>Entertainment</code> || ✓
|-
| segC || reserved custom segment for Instant Articles || <code>'Instant Articles'</code> || ✓
|}


====Metadata for Reporting====
You can reference the table to determine how the metadata you pass is used to define your reporting structure:
{| class="wikitable"
|-
! Reporting Level !! Key !! Description
|-
| Brand || apid || brand is determined by assigned App ID passed during initialization
|-
| Sub-brand || apid || sub-brand is determined is determined by assigned App ID passed during initialization
|-
| Section || section || section or category for the page
|-
| Custom Segment C || segC || Custom segment C is reserved for reporting ‘Instant Articles’. The Instant Articles custom segment will be available under sub-brand and will include the total metrics for all your Instant Articles
|}


==== 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)
|}

== Privacy Policy ==
Nielsen uses cookies for browser measurement. In order to comply with our privacy restrictions,
we ask that you put a link to our Digital Privacy Policy on your Instant Articles pages. You can find our privacy policy here: https://priv-policy.imrworldwide.com/priv/browser/it/it/optout.html

== Going Live ==
Once you have added the DCR Tracking Code to your Instant Articles, Nielsen will validate your implementation after which you must disable Debug logging by deleting {nol_sdkDebug: 'DEBUG'} from the initialization call.

Example:
<syntaxhighlight lang="javascript">
 var nSdkInstance = NOLBUNDLE.nlsQ("PXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXX","nlsnInstance", {nsdkvOverride: "501"});
</syntaxhighlight>