Nielsen DTVR Destination
Nielsen-DTVR is supported on mobile apps and web browsers.
Digital in TV Ratings (DTVR) responds to the shifting, complex multi-platform, multi-device and multi-distribution landscape by providing comprehensive measurement of digital content consumption—including streaming TV commercial video, static web pages and mobile apps—across all major devices and platforms.
In order to get started with Nielsen-DTVR and retrieve an
appid to configure
this integration, you must sign a license agreement on the Nielsen engineering
There will be an NDA to sign prior to accessing the download. Nielsen requires you fill out your company info and have a Nielsen representative before getting started.
You must also go through the pre-certification process as outlined here with your Nielsen representative before shipping this implementation to production.
Install the SDK
The recommended way to install Analytics for iOS is via Cocoapods, since it means you can create a build with specific destinations, and because it makes it dead simple to install and upgrade. Simply add the Analytics dependency to your Podfile, like so:
pod 'Analytics' '~> 3.0' pod 'Segment-Nielsen-DTVR'
Add the Nielsen App SDK Framework
The integration relies on the NielsenApp SDK framework, which can either be installed via CocoaPods or by manually adding the framework. You will need to have a Nielsen representative before getting started.
When using the Nielsen SDK version 18.104.22.168 and above, Nielsen recommends installation via CocoaPods, and Apple recommends using the dynamic framework.
Requirements for CocoaPods:
Dynamic Framework - version 1.6.1 or higher Static Framework - version 1.4.0 or higher
- Set repository credentials The first step is to add the credentials received
from Nielsen into your .netrc file. Navigate to your home folder and create a
file called .netrc
cd ~/ vi .netrc
Add the credentials in the following format:
machine raw.githubusercontent.com login <Nielsen App SDK client> password <Auth token>
You will need to fill out a license agreement form and have the contact information for your Nielsen representative in order to obtain the credentials here
- Add the source to your Podfile:
Dynamic Framework -
Note - you will also need to include
Static Framework -
- Add the pod to your Podfile:
- Install pods
The full instructions from Nielsen can be found here
Navigate to the Nielsen Downloads page to download the iOS SDK. You will need to fill out a license agreement form and have the contact information for your Nielsen representative ready.
Once extracted, add the static NielsenAppApi.framework to the project and
ensure it’s in the
Frameworks folder, and that it is linked.
Nielsen also requires the following frameworks, which must be included into Link Binary with Libraries (within app target’s Build Phases). However, if using the dynamic framework, these will dynamically be linked and there is no need to manually link these. - AdSupport.framework - SystemConfiguration.framework - CoreLocation.framework (Not applicable for International (Germany)) - libsqlite3
To install the Segment-Nielsen-DTVR integration, you will first want to add
Nielsen’s maven repository to your app’s module
build.gradle file. Nielsen
provides information on what your
build.gradle file should look like after
adding their repository here in their
To retrieve Nielsen credentials, you will need to fill out a license agreement form here
An easy way to configure your app with your Nielsen credentials is to set the
ENV variables, for example:
export ORG_GRADLE_PROJECT_NIELSEN_USER=<nielsen_user> export ORG_GRADLE_PROJECT_NIELSEN_AUTHCODE=<nielsen_authCode>
Then, to include Segment’s Nielsen-DTVR module, simply add the following line
to your module-level
If you’d like to measure video on the web, all you have to do is add your
instanceName in your Segment settings and enable this
destination for a JS source. We will then load the Nielsen SDK into the
Segment only supports sending
track events as outlined in our Video
Spec. To get started tracking video content through
Segment, make sure you are using a media player that has an API which allows
you to detect the player state such as video or ad plays. For example, you
would not be able to collect ad plays using YouTube since their YouTube SDK
does not expose any hooks into player states during ad plays.
IMPORTANT: If you do not implement the Segment Video Spec properly with key lifecycle events, this integration will not behave properly.
Again, please also refer to our Video Spec and implement video tracking as outlined there. We will map the semantic events and properties to Nielsen’s relevant methods and metadata.
Once the Segment source is integrated with your app, toggle
Nielsen-DTVR on in your Segment destinations catalog, and add your
which you can retrieve from your Nielsen representative.
appId is the unique id for the application assigned by Nielsen. It is
GUID data type. Be sure to use the test
appId during development, test, and
certification processes. Use Production appid to submit app to App / Play
store, after receiving Nielsen certification.
These new settings will take up to an hour to propagate to all of your existing users. For new users it will be instantaneous.
Enable Debug Mode
Check this setting if you would like to activate the Debug flag. Once the flag is active, it logs each API call made and the data passed. DO NOT activate the Debug flag in a production environment.
Indicate the key in your payload associated with the id3 tag.
If one is not provided we will default to
Required for Web only: A user-defined string value for describing the player/site.
Events to Send Id3 Tags
Add the event names you would like to trigger Segment to
Required for mobile only: Add the unique identifier for the
environment that the Nielsen SDK should point to. If not specified the default
value will be
This page was last modified: 31 Jan 2020
Questions? Problems? Need more info? Contact us, and we can help!