DCR Germany Static Google AMP Cloud API

From Engineering Client Portal

Revision as of 14:19, 8 December 2022 by MichelFodjo (talk | contribs)

Engineering Portal breadcrumbArrow.png Digital breadcrumbArrow.png AGF Implementation Documentation breadcrumbArrow.png DCR Germany Static Google AMP Cloud API

Overview

This guide will show you how to enable Digital Content Ratings (DCR) Static measurement on Google AMP.


Prerequisites

To get started, an AppID is needed. The AppID is a unique ID assigned to the player/site/app. This will be provided upon starting the integration from Nielsen.

Note: The value for the 'apid' you pass for AMP measurement should not include the 'P' prefix that is otherwise present on other SDK-related implementations

  apid: "XXXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX" // eg. PDA7D5EE6-B1B8-XXXX-XXXX-2A788BCXXXCA

Step 1: Import the Google AMP Analytics Javascript Library

If you have not already, you will need to import the AMP JS library in the <head> of your webpage in order to create an AMP page:

 <!-- Load AMP -->
<script async src="https://cdn.ampproject.org/v0.js"></script>


Next, Load amp-analytics by adding the following line to the <head> of the webpage:

<script async custom-element="amp-analytics" src="https://cdn.ampproject.org/v0/amp-analytics-0.1.js"></script>

Note: AMP pages require all traffic to be using HTTPS, including the webpage itself


Step 2: Specify the Analytics Provider

DCR measurement can now be added to your AMP pages through the amp-Analytics custom-element:

<amp-analytics type="nielsen">
    <!-- Add Nielsen DCR Tags here -->
</amp-analytics>

For more information on the Analytics type, you can refer to the Analytics vendors section of Google's AMP Developer Documentation.

Step 3: Configure the Metadata

You will need to match the metadata fields on your AMP page with those of your non-AMP page.


Step 3.1: Add the Metadata to Nielsen DCR Tags

Note: The value for the 'apid' you pass for AMP measurement should not include the 'P' prefix that is otherwise present on other SDK-related implementations

The full description of the other key/value pairs for Metadata can be found here: AGF Metadata Convention for Static Measurement

<amp-analytics type="nielsen">
    <script type="application/json">
        {
            "vars": {
                "apid": "Mandatory - your AppID received from Nielsen",
                "assetid": "Mandatory - your unique assetid",
                "section": "Mandatory - your section",
                "segA": "Mandatory - your AGOF Code",
                "segB": "Mandatory - your SegB",
                "segC": "Optional - your program name",
                "subbrand": "Mandatory - your subbrand received from Nielsen"
            },
            "requests": {
               
            }
        }
    </script>
</amp-analytics>

Step 3.2: Add Nielsen request configuration parameters to Nielsen DCR Tags

Please do not modify this Tag!

<amp-analytics type="nielsen">
    <script type="application/json">
        {
            "vars": {
            },
            "requests": {
                "session": "https://eu-uaid-linkage.nmrodam.com/cgi-bin/gn?prd=session&c13=asid,P${apid}&sessionId=${pageViewId64}_${pageViewId}&pingtype=4&enc=false&c61=createtm,${timestamp}&rnd=${random}",
                "cloudapi": "https://agfcapi.nmrodam.com/nmapi/v2/${apid}/${pageViewId64}_${pageViewId}/a?b=%7B%22devInfo%22%3A%7B%22devId%22%3A%22${pageViewId64}_${pageViewId}%22%2C%22apn%22%3A%22${apn}%22%2C%22apv%22%3A%22${apv}%22%2C%22apid%22%3A%22${apid}%22%7D%2C%22metadata%22%3A%7B%22static%22%3A%7B%22type%22%3A%22static%22%2C%22section%22%3A%22${section}%22%2C%22assetid%22%3A%22${assetid}%22%2C%22segA%22%3A%22${segA}%22%2C%22segB%22%3A%22${segB}%22%2C%22segC%22%3A%22${segC}%22%2C%22subbrand%22%3A%22${subbrand}%22%2C%22adModel%22%3A%220%22%2C%22dataSrc%22%3A%22cms%22%7D%2C%22content%22%3A%7B%7D%2C%22ad%22%3A%7B%7D%7D%2C%22event%22%3A%22playhead%22%2C%22position%22%3A%22${timestamp}%22%2C%22data%22%3A%7B%22hidden%22%3A%22${backgroundState}%22%2C%22blur%22%3A%22${backgroundState}%22%2C%22position%22%3A%22${timestamp}%22%7D%2C%22type%22%3A%22static%22%2C%22utc%22%3A%22${timestamp}%22%2C%22index%22%3A%22${requestCount}%22%2C%22pageURL%22%3A%22${ampdocUrl}%22%7D"
            }
        }
    </script>
</amp-analytics>

Step 3.3: Review sample Nielsen DCR Tag for Content"

<amp-analytics type="nielsen">
    <script type="application/json">
        {
            "vars": {
                "apid": "0A3CA5B6-4D32-42E7-9B9D-97A807C43469",
                "assetid": "CloudAPIRefImpStaticDE_gAMPstatic",
                "section": "home_page",
                "segA": "AGOF_Code_Nlsn",
                "segB": "CPI",
                "segC": "Program_Name_Nlsn",
                "subbrand": "c01"
            },
            "requests": {
                "session": "https://eu-uaid-linkage.nmrodam.com/cgi-bin/gn?prd=session&c13=asid,P${apid}&sessionId=${pageViewId64}_${pageViewId}&pingtype=4&enc=false&c61=createtm,${timestamp}&rnd=${random}",
                "cloudapi": "https://agfcapi.nmrodam.com/nmapi/v2/${apid}/${pageViewId64}_${pageViewId}/a?b=%7B%22devInfo%22%3A%7B%22devId%22%3A%22${pageViewId64}_${pageViewId}%22%2C%22apn%22%3A%22${apn}%22%2C%22apv%22%3A%22${apv}%22%2C%22apid%22%3A%22${apid}%22%7D%2C%22metadata%22%3A%7B%22static%22%3A%7B%22type%22%3A%22static%22%2C%22section%22%3A%22${section}%22%2C%22assetid%22%3A%22${assetid}%22%2C%22segA%22%3A%22${segA}%22%2C%22segB%22%3A%22${segB}%22%2C%22segC%22%3A%22${segC}%22%2C%22subbrand%22%3A%22${subbrand}%22%2C%22adModel%22%3A%220%22%2C%22dataSrc%22%3A%22cms%22%7D%2C%22content%22%3A%7B%7D%2C%22ad%22%3A%7B%7D%7D%2C%22event%22%3A%22playhead%22%2C%22position%22%3A%22${timestamp}%22%2C%22data%22%3A%7B%22hidden%22%3A%22${backgroundState}%22%2C%22blur%22%3A%22${backgroundState}%22%2C%22position%22%3A%22${timestamp}%22%7D%2C%22type%22%3A%22static%22%2C%22utc%22%3A%22${timestamp}%22%2C%22index%22%3A%22${requestCount}%22%2C%22pageURL%22%3A%22${ampdocUrl}%22%7D"
            }
        }
    </script>
</amp-analytics>


Step 4: Review Privacy and Opt-Out

The Google AMP measurement is working without cookies and other personal information. No user can be identified personally, therefore an opt-out functionality is not required. The Nielsen static measurement is utilizing a cookieless domain.

In order to disclose Nielsen measurement privacy statement, please include the following items in your privacy policy:

Step 5: Testing and going Live

Please provide your test builds to Nielsen for Certification, you can then go live after the certification process.


Step 6: Review the Sample Implementation for your Reference

The Sample Google AMP Implementation for AGF is located here.