Configuring Nielsen Digital Ad Ratings


• This Instant TV Channel help article only applies to Developer SDK Roku channels. Nielsen DAR (Digital Ad Ratings) is automatically supported in Direct Publisher Roku channels.
You must be authorized by Roku before using Nielsen DAR with your Developer SDK Roku channel. Please contact Roku, Nielsen or for additional information. By enabling Nielsen DAR in your Roku channel, you agree to these terms and conditions provided by Roku.
• Your Instant TV Channel account Developer Mode must be set to Advanced in order to view or change Nielsen DAR related settings. You can change the Developer Mode from the Instant TV Channel Account page.
• Your channel must be a Commercial channel type. Free and Unlimited channel types do not support Nielsen DAR.
• Your channel must either be newly created, or be at Update #305 or higher in order to use Nielsen DAR with your Roku channel.

Nielsen Digital Ad Ratings provides a comprehensive, next-day view of your ad performance in a way comparable to Nielsen TV ratings. In the context of a Roku channel, Nielsen DAR provides additional value to your RAF video advertisements and may increase your advertising revenue. If you are not a Nielsen DAR customer, you may not receive reports on DAR campaigns.

The Roku implementation of Nielsen DAR embeds information about the specific video item, such as genre, name, and runtime, into the VAST requests for video ads in your channel. In addition to the genre settings, Nielsen DAR requires an accurate Title parameter and Length parameter for each video in order to function correctly. When using Nielsen DAR the Title parameter for each video should consistently reflect the program (movie title or series name), and should not uniquely identity episodic content unless formatted with a hyphen or parenthesis as described below:

Examples:
    "The Price is Right"
    "Leave It To Beaver"
    "Police Academy 7: Mission to Moscow"

If it is necessary to include episodic information in the Title parameter, then the episodic information should be separated using a hyphen or surrounded by parenthesis. The episodic portion of the Title parameter will be automatically removed before sending it to Nielsen DAR, although the complete Title parameter will display as usual on the Springboard screen and elsewhere:

Examples:
    "Leave It To Beaver - Episode 5"
    "Leave It To Beaver (Episode 5)"
    "Leave It To Beaver - Wally Takes a Walk"
    "Leave It To Beaver (Wally Takes a Walk)"

If using a hyphen, the hyphen must be preceded by and followed by a space character as in the previous examples. Hyphens not surrounded by spaces will be treated as part of a word instead of as an episodic information separator.

To enable Nielsen DAR in your Roku channel please perform the following steps:

  1. Set the Theme IncludeRAF parameter to "True". If the value of IncludeRAF was originally "False" you will need to re-package your channel, re-upload the Pkg file to your Roku Developer Account, and resubmit the channel to Roku for approval after completing the rest of the steps below.
  2. Set the Theme RAFNielsenEnabled parameter to "True".
  3. If Nielsen has provided you with your own App ID, enter it into the Theme RAFNielsenAppId parameter, otherwise use the default Roku App ID "P2871BBFF-1A28-44AA-AF68-C7DE4B148C32".
  4. Change the Theme RAFNielsenGenreDefault parameter to the default genre that best describes your channel's content. This genre setting initially applies to all videos in the channel, but can be overridden by individual videos.
  5. If the Theme RAFNielsenGenreDefault parameter is not the best match for the genre of a particular video item, the video item should override the Theme RAFNielsenGenreDefault parameter as described below.

To override the Theme RAFNielsenGenreDefault parameter and set the Nielsen Genre for an individual video item created with Instant TV Channel Update #305 or later, please perform the following steps:

  1. From the Instant TV Channel Content page, select the video item for which you want to set the Nielsen Genre.
  2. Set the video item's NielsonGenre parameter to the most specific genre applicable to the content.
  3. To use the genre specified by the Theme RAFNielsenDefaultGenre parameter, set NielsonGenre parameter to "Default".
  4. Video items created in versions of Instant TV Channel prior to Update #305 do not have a NielsonGenre parameter.

To override the Theme RAFNielsenGenreDefault parameter and set the Nielsen Genre for an individual video item created with a version of Instant TV Channel before Update #305, please perform the following steps:

  1. From the Instant TV Channel Content page, select the video item for which you want to set the Nielsen Genre.
  2. Insert the 1 or 2 character Nielsen Genre Code from the following table into the beginning of the Categories parameter, followed by a space. The remaining text in the Categories parameter, if any, is displayed on the Springboard screen as usual. The Nielsen Genre code will not be displayed in the Categories area of the Springboard screen.
Nielsen DAR Genre Codes
Genre Code Genre Description
A Adventure
AP Audience Participation
AC Award Ceremonies & Pageants
CP Children's Programming
CV Comedy Variety
CM Concert Music
CC Conversation, Colloquies
DD Daytime Drama
D Devotional
DO Documentary, General
DN Documentary, News
EA Evening Animation
FF Feature Film
GD General Drama
GV General Variety
IA Instructions, Advice
MD Musical Drama
N News
OP Official Police
P Paid Political
PV Participation Variety
PC Popular Music - Contemporary
PS Popular Music - Standard
PD Private Detective
QG Quiz - Give Away
QP Quiz - Panel
SF Science Fiction
CS Situation Comedy
SA Sports Anthology
SC Sports Commentary
SN Sports News
SE Sports Event
SM Suspense/Mystery
EW Western Drama


Need help with monetizing your Roku channel using video advertisements? See Placing Advertisements in your Roku Channel for all the details!

Comments, suggestions, or questions about this Roku developer guide can be sent to .

Instant TV Channel is a cloud-based tool for Roku developers and content providers that shortens development time and eases maintenance after deployment.



Private Channel Code: ITVC
Check out Instant TV Channel by adding our demonstration channel to your Roku player, or watch the YouTube video.

Need help with your Roku?

We are unable to provide technical support for your Roku device or for channels not created using Instant TV Channel.

Please visit www.roku.com for assistance.



Instant TV Channel is not affiliated with nor endorsed by Roku Inc.