Content Object

This object describes the content in which the impression will appear, which may be syndicated or nonsyndicated content. This object may be useful when syndicated content contains impressions and does
not necessarily match the publisher’s general content. The exchange might or might not have
knowledge of the page where the content is running, as a result of the syndication method. For
example might be a video impression embedded in an iframe on an unknown web property or device.

AttributeTriplelift RequiredTypeDescription
idstringID uniquely identifying the content.
episodeintegerEpisode number.
titlestringContent title.
Video Examples: “Search Committee” (television), “A New
Hope” (movie), or “Endgame” (made for web).
Non-Video Example: “Why an Antarctic Glacier Is Melting So
Quickly” (Time magazine article).
seriesstringContent series.
Video Examples: “The Office” (television), “Star Wars” (movie),
or “Arby ‘N’ The Chief” (made for web).
Non-Video Example: “Ecocentric” (Time Magazine blog).
seasonstringContent season (e.g., “Season 3”).
artiststringArtist credited with the content.
genrestringGenre that best describes the content (e.g., rock, pop, etc).
albumstringAlbum to which the content belongs; typically for audio.
isrcstringInternational Standard Recording Code conforming to ISO3901.
producerobject (see below)Details about the content Producer.
urlstringURL of the content, for buy-side contextualization or review.
catstring arrayArray of IAB content categories that describe the content
producer.
prodqstring arrayProduction quality.
videoqualityintegerPer ORTB Spec 2.5: Deprecated in favor of prodq.
contextintegerType of content (game, video, text, etc.).
contentratingstringContent rating (e.g., MPAA)
userratingstringUser rating of the content (e.g., number of stars, likes, etc.).
qagmediaratingintegerMedia rating per IQG guidelines.
keywordsstringComma separated list of keywords describing the content.
livestreaminteger0 = not live, 1 = content is live (e.g., stream, live blog).
sourcerelationshipinteger0 = indirect, 1 = direct.
lenintegerLength of content in seconds; appropriate for video or audio.
languagestringContent language using ISO-639-1-alpha-2.
embeddableintegerIndicator of whether or not the content is embeddable (e.g.,
an embeddable video player), where 0 = no, 1 = yes.
dataobject array (see below)Additional content data. Each Data object represents a different data source.
extobjectPlaceholder for exchange-specific extensions to OpenRTB.

Producer Object

This object defines the producer of the content in which the ad will be shown. This is particularly useful
when the content is syndicated and may be distributed through different publishers and thus when the
producer and publisher are not necessarily the same entity.

AttributeTriplelift RequiredTypeDescription
idstringContent producer or originator ID. Useful if content is
syndicated and may be posted on a site using embed tags.
namestringContent producer or originator name (e.g., “Warner Bros”).
catstring arrayArray of IAB content categories that describe the content
producer.
domainstringHighest level domain of the content producer (e.g.,
“producer.com”).
extobjectPlaceholder for exchange-specific extensions to OpenRTB.

Data Object

The data and segment objects together allow additional data about the related object (e.g., user,
content) to be specified. This data may be from multiple sources whether from the exchange itself or
third parties as specified by the id field. A bid request can mix data objects from multiple providers.
The specific data providers in use should be published by the exchange a priori to its bidders

AttributeTriplelift RequiredTypeDescription
idstringExchange-specific ID for the data provider.
namestringExchange-specific name for the data provider.
segmentobject array (see below)Array of Segment objects that contain the
actual data values
extobjectPlaceholder for exchange-specific extensions to OpenRTB.

Segment Object

Segment objects are essentially key-value pairs that convey specific units of data. The parent Data
object is a collection of such values from a given data provider. The specific segment names and value
options must be published by the exchange a priori to its bidders.

AttributeTriplelift RequiredTypeDescription
idstringID of the data segment specific to the data provider
namestringName of the data segment specific to the data provider
valuestringString representation of the data segment value.
extobjectPlaceholder for exchange-specific extensions to OpenRTB.