Nielsen DCR Analytics
The following document describes how to implement the Nielsen DCR module for AMP Android SDK.
It also assumes you have started conversations with a Nielsen representative for them to provide you with some custom metadata specific to your Android app that you will need in Point #5 of this guide (
This guide follows the
AmpAnalyticsNielsenDcrSample Android Studio project, found in our release page. To integrate the plugin into your App, you need to:
1) Add the following
.jars to your project’s
appsdk.jar(provided by Nielsen)
amp-analytics-nielsen-dcr.jar(provided by Akamai)
2) In the
Activity where playback is handled, import the following Java packages:
import com.akamai.amp.analytics.nielsenanalytics.AmpNielsenDcrAnalyticsTracker; import com.akamai.amp.analytics.nielsenanalytics.NielsenDcr; import com.akamai.amp.config.data.NielsenAdData; import com.akamai.amp.config.data.NielsenAppData; import com.akamai.amp.config.data.NielsenContentData; import com.akamai.amp.config.data.NielsenData;
3) Add an object of the
AmpNielsenDcrAnalyticsTracker type in your
private AmpNielsenDcrAnalyticsTracker nielsenAnalytics;
4) Initialize that object on the
onResourceReady() method from the
nielsenAnalytics = NielsenDcr.create(videoPlayerView, buildNielsenData());
buildNielsenData() method, returns a
com.akamai.amp.config.data.NielsenData object, which is composed of
NielsenAdData. Those objects receive a
java.util.Map of two Strings: the beacon’s name and its value. Each one of them also has the following methods that return a
getAllMetadata(): will return all the available beacon names.
getMandatoryMetadata(): will return all the mandatory available beacon names.
For an example of how to fill this data, check the
PlayerActivity.java file from the
6) If your App integrates ads, the ad component has to send the different events to AMP’s Nielsen object. For example, using Google IMA Ads (
7) To get certified by Nielsen, it is mandatory to present to the customer an opt-out page. The
AmpNielsenDcrAnalyticsTracker provides this custom URL with the method
getOptOutUrl(). Refer to
OptOutActivity.java for an implementation example.
8) Now that everything has been integrated, contact a Nielsen representative to get the "Nielsen DCR Pre-Certification Checklist" PDF.
Once you have validated that every item on the checklist is correct, send your App to Nielsen for certification.
If you have further questions or comments, reach out to us via firstname.lastname@example.org