Content Object

Content Object Properties

Value

Type

Description

id*

string

ID uniquely identifying the content.

episode*

integer

Episode number.

title*

string

Content title e.g., Lost Kingdom - SE02 EP03

season*

string

Content season e.g., "Season 3"

artist*

string

Artist credited with the content

genre*

string

Genre that best describes the content, e.g., rock, pop, etc. You may need to discuss with your trading partners about aligning around a particular taxonomy. There’s a few taxonomies for defining the genre, the IAB Content taxonomy being the most standard one at the moment.

album*

string

Album to which the content belongs; typically for audio.

isrc*

string

International Standard Recording Code conforming to ISO-3901.

url*

string

A single URL of the content, for buy-side contextualization or review.

cat*

array of strings

Array of content categories using IDs from the IAB taxonomy.

prodq*

integer

Production quality: 1 Professionally Produced, 2 Prosumer 3 User Generated (UGC)

context*

integer

Type of content

  • 1 Video (i.e., video file or stream such as Internet TV broadcasts)

  • 2 Game (i.e., an interactive software game)

  • 3 Music (i.e., audio file or stream such as Internet radio broadcasts)

  • 4 Application (i.e., an interactive software application)

  • 5 Text (i.e., primarily textual document such as a web page, eBook, or news article)

  • 6 Other (i.e., none of the other categories applies)

  • 7 Unknown

rating*

string

Content rating (e.g., MPAA).

urating*

string

User rating of the content (e.g., number of stars, likes, etc.).

mrating*

integer

Media rating per IQG guidelines. Refer to List: Media Ratings.

  • 1 All Audiences

  • 2 Everyone Over Age 12

  • 3 Mature Audiences

keywords*

string

Comma separated list of keywords describing the content.

live*

integer

Indication of live content, where 0 = not live, 1 = live (e.g., stream, live blog).

Note: This may also be passed as livestream due to the difference between Open RTB 2.5 and 3.0.

srcrel*

integer

Source relationship, where 0 = indirect, 1 = direct.

len*

integer

Length of content in seconds; typically for video or audio.

lang*

string

Content language using ISO-639-1-alpha-2.

Note: This may also be passed a language due to the difference between Open RTB 2.5 and 3.0.

embed*

integer

Indicator of whether or not the content is embedded off-site from the the site or app described in those objects (e.g., an embedded video player), where 0 = no, 1 = yes.

producer*

object

Details about the content producer. Refer to Object: Producer.

data*

array of objects

Additional user data. Each Data object represents a different data source, see the Data Object
Content Object Example
{
  "content":{
    "cat":[
      "IAB-1",
      "IAB-2"
    ],
    "contentrating":"MPAA",
    "context":1,
    "episode":1,
    "genre":"comedy",
    "id":"472759950",
    "language":"en",
    "len":15,
    "live":1,
    "prodq":1,
    "series":"string",
    "title":"Law & Order Criminal Intent S03 - Ep18 Ill-Bred HD Watch",
    "url":"https://forums.watchuseek.com/showthread.php",
    "userrating":"4.1"
  }
}