App.content

A Content object describing what is playing or displayed inside the app. On CTV it carries the show-level detail: series, season, episode, network, and channel.

CurrentobjectOptionalSince 2.0

Field facts

Path
app.content
Object
App
Type
object
Requirement
Optional
Added
OpenRTB 2.0
Spec section
3.2.14

How it is used

For streaming and CTV apps, this object is where buyers learn what the viewer is watching, so fill Content.series, Content.season, Content.episode, Content.network, and Content.channel whenever the player knows them. Many FAST and aggregator apps send an empty or thin object because the ad server does not know the program at bid time, and some buyers then infer the show from App.bundle and the device instead.

Example

Where the field sits in a payload, with everything else left out:

{
  "id": "req-1",
  "app": {
    "content": {
      "id": "ep-2201",
      "series": "Harbor City",
      "season": "Season 4",
      "episode": 12,
      "title": "The Night Shift",
      "len": 2700,
      "livestream": 0,
      "network": {
        "name": "Northwind Broadcasting"
      },
      "channel": {
        "name": "Northwind Drama"
      }
    }
  }
}

Version history

Added in OpenRTB 2.0, and present in the latest snapshot. The table shows how each version's spec text types the field.

VersionsType in the specRequiredDeprecated
2.0 to 2.2objectNoNo
2.3 to 2.3.1objectNoNo
2.4objectNoNo
2.5 to 2.6-202606objectNoNo

Related fields

Other App fields