Digital Measurement Metadata

From Engineering Client Portal

Engineering Portal breadcrumbArrow.png Digital breadcrumbArrow.png US DCR & DTVR breadcrumbArrow.png Digital Measurement Metadata

Digital Metadata

Digital Metadata can passed through key-values using the Nielsen reserved keys. The keys and values are listed by product below.

Digital Content Ratings (DCR) Metadata

Video Metadata

Keys Description Values Required
type type of asset "content" Yes
assetid unique ID assigned to asset custom Yes
program name of program (25 character limit.)
(no abbreviations or shorthand)
The Big Bang Theory Yes
title episode title with season and episode number (40 character limit) The Pants Alternative S03E18 Yes
length length of content in seconds If continuous (24 x 7) stream, pass the value of 86400.
If live stream of a discrete program (Live Event/Sporting Event),
pass length of content. If unknown, pass a value of 0.
Yes
airdate original broadcast or release date for the program iso date format
(YYYY-MM-DDThh:mm:ssTZD)
2021-03-21T12:00:00Z
2021-03-21T12:00:00-5000
Yes
isfullepisode full episode flag "y"- full episode, "n"- non full episode Yes
adloadtype type of ad load:

"1" Linear – matches TV ad load

"2" Dynamic – Dynamic Ad Insertion (DAI)

"2" - DCR measures content with dynamic ads Yes
segB custom segment B custom
segC custom segment C custom
crossId1 TMS ID provided by gracenote custom
crossId2 content originator (only required for distributors) custom

Custom segments (segB and segC) can be used to aggregate video and/or static content within a single Brand to receive more granular reports within a brand.

Examples regarding usage of segments within SDK:

  • All comedy clips and stories for a Brand rolled into a "Comedy" segment
  • genre grouping content by Comedy vs. Drama
  • group related Text + Video content - i.e. for a show that has a lot of - static pages associated with it
  • packaging based on how clients sell inventory
  • grouping related types of content either by genre, category or platform.


Example Video Metadata Object

var contentMetadataObject =
{  
  type:           'content',
  assetid:        'VID-123456',
  program:        'The Big Bang Theory',
  title:          'The Pants Alternative S03E18',  //no abbreviations or shorthand
  length:         '1320',   //lengths in seconds
  airdate:        '2021-03-21T12:00:00Z',
  isfullepisode:  'y',
  adloadtype:     '2',
  segB:           'custom segment B', // optional
  segC:           'custom segment C', // optional
  crossId1:       'Standard Episode ID', // optional
  crossId2:       'Content Originator' //optional
};

Ad Metadata

The Ad Metadata (if applicable) should be passed for each individual ad.

Keys Description Values Required
type type of Ad 'preroll', 'midroll', 'postroll'
'ad' - If specific type can not be identified.
assetid unique ID assigned to Ad custom
(no Special Characters)

Example Ad Object

var adMetadataObject = 
{  
  type:    'preroll',
  assetid: 'AD-1'
};

Static Metadata

Key Description Data Type Value Required?
type asset type fixed 'static' Yes
assetid Unique ID for each article dynamic custom
(no Special Characters)
Yes
section section of each site (e.g. section value should be first level in page URL: website.com/section). Limit to 25 unique values dynamic custom
(no Special Characters)
Yes
segA custom segment for reporting: Limit to 25 unique values across custom segments (segA + segB + segC) dynamic custom No
segB custom segment for reporting: Limit to 25 unique values across custom segments (segA + segB + segC) dynamic custom No
segC custom segment for reporting: Limit to 25 unique values across custom segments (segA + segB + segC) dynamic custom No

The values passed through the Nielsen keys will determine the breakouts that are seen in reporting. The custom segments (A, B & C) will roll into the sub-brand. To not use custom segments A, B and C, do not pass any value in these keys.

Example Static Metadata Object

var contentMetadataObject =
{  
  type: 'static', 
  assetid: 'HHF887465-9486', // *DYNAMIC METADATA*: unique ID for each article **REQUIRED**
  section: 'SPORTS', // *DYNAMIC METADATA*: section of site **REQUIRED**
  segA: 'HD Videos', // *DYNAMIC METADATA*: custom segment
  segB: '', // *DYNAMIC METADATA*: custom segment
  segC: ''  // *DYNAMIC METADATA*: custom segment
};

Digital TV Ratings (DTVR) Metadata

Content Metadata

Key Description Values Required
type type of asset "content"
adModel linear vs dynamic ad model * 1) - Linear – matches TV ad load * 2) Dynamic – Dynamic Ad Insertion (DAI)

Example Content Object

 var contentMetadataObject =
{  
  type: 'content',
  adModel: '1'
};

Custom Variables Extension

If you are looking for additional reporting options, reach out to us. We have a Custom Variables Extension and can work with you to obtain your desired reporting.