Site.content

A Content object describing what the user is reading, watching, or hearing on the site. It is optional and most useful when the media differs from the site's general topic, as with an embedded video player.

CurrentobjectOptionalSince 2.0

Field facts

Path: site.content
Object: Site
Type: object
Requirement: Optional
Added: OpenRTB 2.0
Spec section: 3.2.13

How it is used

On the web, Content matters most for video players and syndicated material, where the page and the media can belong to different owners. For an article, Content.url and Content.title are enough; for video, add the series, episode, and producer fields.

Example

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

{
  "id": "req-1",
  "site": {
    "content": {
      "id": "vid-5531",
      "title": "Transit vote explained",
      "url": "https://news.example.com/video/transit-vote-explained",
      "len": 184,
      "context": 1
    }
  }
}

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.

Versions	Type in the spec	Required	Deprecated
2.0 to 2.2	object	No	No
2.3 to 2.3.1	object	No	No
2.4	object	No	No
2.5 to 2.6-202606	object	No	No