Template

Difference between revisions of "DCR Content Metadata"

From Engineering Client Portal

Line 4: Line 4:
 
! '''Keys''' !! '''Description''' !! '''Values''' !! '''Required'''
 
! '''Keys''' !! '''Description''' !! '''Values''' !! '''Required'''
 
|-
 
|-
| type || type of asset || <code>"content"</code> || Yes
+
| type || type of asset ||For Video use: <code>"content"</code><br> For Static or text <code>"static"</code> || Yes
 
|-style="background-color:#e9f9fa;"
 
|-style="background-color:#e9f9fa;"
| assetid || unique ID assigned to asset || custom || Yes
+
| assetid || unique ID assigned to asset <br> Note: Refrain from using the following special characters [[Special_Characters|(Special Characters)]] || Examples: <br> <code>BBT345a234 </code> <br> <code>CBSs5e234F2021</code>  || Yes
 
|-
 
|-
| program ||name of program (25 character limit.) <br> (no abbreviations or shorthand) || The Big Bang Theory || Yes
+
| program ||Complete program or movie title. <br> (no abbreviations or shorthand) <br> Note: there is a 25 character limit.  ||<code> The Big Bang Theory</code> <br> <code> TheBigBangTheory</code> <br><code> The Dark Knight</code> <br><code> TheDarkKnight</code> <br> || Yes
 
|-style="background-color:#e9f9fa;"
 
|-style="background-color:#e9f9fa;"
| title ||episode title with season and episode number (40 character limit) <br> (Formats accepted: S01E03, S1E3, S1 E3) || Examples: <br> <code>The Pants Alternative S03E18</code> <br> <code>The Pants Alternative S3E18</code> <br> <code>The Pants Alternative S3 E18</code>|| Yes
+
| title ||episode title with season and episode number (40 character limit) <br> (Formats accepted: S01E03, S1E3, S1 E3) || Examples: <br> <code>The Pants Alternative S03E18</code> <br> <code>The Pants Alternative S3E18</code> <br> <code>The Pants Alternative S3 E18</code> <br> Can also accept: <code> S3E18</code> <br> Not Valid: <code> 318 </code> or <code> 0318 </code>|| Yes
 
|-
 
|-
 
| crossId1 || The Gracenote TMS ID (If available) || The TMS ID will be a 14 character string. <br> Normally being with  'EV,' 'EP', 'SH', 'SP', or 'MV' <br> Followed by 12 numbers after the initial two letter prefix. <br> <br> The Giant Morning Show: <code>SH009311820022</code> <br> The Pants Alternative Episode : <code>EP009311820061</code> ||  
 
| crossId1 || The Gracenote TMS ID (If available) || The TMS ID will be a 14 character string. <br> Normally being with  'EV,' 'EP', 'SH', 'SP', or 'MV' <br> Followed by 12 numbers after the initial two letter prefix. <br> <br> The Giant Morning Show: <code>SH009311820022</code> <br> The Pants Alternative Episode : <code>EP009311820061</code> ||  

Revision as of 20:14, 2 May 2022

Keys Description Values Required
type type of asset For Video use: "content"
For Static or text "static"
Yes
assetid unique ID assigned to asset
Note: Refrain from using the following special characters (Special Characters)
Examples:
BBT345a234
CBSs5e234F2021
Yes
program Complete program or movie title.
(no abbreviations or shorthand)
Note: there is a 25 character limit.
The Big Bang Theory
TheBigBangTheory
The Dark Knight
TheDarkKnight
Yes
title episode title with season and episode number (40 character limit)
(Formats accepted: S01E03, S1E3, S1 E3)
Examples:
The Pants Alternative S03E18
The Pants Alternative S3E18
The Pants Alternative S3 E18
Can also accept: S3E18
Not Valid: 318 or 0318
Yes
crossId1 The Gracenote TMS ID (If available) The TMS ID will be a 14 character string.
Normally being with 'EV,' 'EP', 'SH', 'SP', or 'MV'
Followed by 12 numbers after the initial two letter prefix.

The Giant Morning Show: SH009311820022
The Pants Alternative Episode : EP009311820061
crossId2 content originator (only required for distributors) custom
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
For USA, date should be EST
Outside USA, date should be local time.
Acceptable Formats
YYYYMMDD HH24:MI:SS
YYYYMMDDHH24MISS
YYYY-MM-DDTHH:MI:SS
YYYY-MM-DDHH:MI:SS
YYYYMMDDHH:MI:SS
MM-DD-YYYY
YYYYMMDD HH:MI:SS
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

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.