Content Object

Note

Due to how many Suppliers and Buyers adopted the content object after oRTB 3.0 was released, there can be some variations in how field names are really used as two options exist for some in the content object, e.g. userrating in 2.5 is urating in 3.0.

Here is the complete Adcom Content Object Specification.

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).

Note: This may also be passed as videoquality

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).

Note: this may also be passed as contentrating

urating*

string

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

Note: this may also be passed as urating

mrating*

integer

Media rating per IQG guidelines. Refers to the following list:

  • 1 All Audiences

  • 2 Everyone Over Age 12

  • 3 Mature Audiences

  • Note: this may also be passed as qagmediarating

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.

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

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.

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

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"
    ],
    "rating":"MPAA",
    "context":1,
    "episode":1,
    "genre":"comedy",
    "id":"472759950",
    "lang":"en",
    "len":15,
    "live":1,
    "prodq":1,
    "season":"Season 3",
    "title":"Law & Order Criminal Intent S03 - Ep18 Ill-Bred HD Watch",
    "url":"https://forums.watchuseek.com/showthread.php",
    "urating":"4.1"
  }
}