Content.episode

The episode number, as an integer. Together with Content.series and Content.season, it identifies one episode of a show.

CurrentintegerOptionalSince 2.0

Field facts

Path: app.content.episode, dooh.content.episode, site.content.episode
Object: Content
Type: integer
Requirement: Optional
Added: OpenRTB 2.0
Spec section: 3.2.16

How it is used

One of the core CTV show-level fields. Use the number the publisher's catalog gives the episode, usually its position within the season, and keep it consistent across requests.

Example

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

{
  "id": "req-1",
  "app": {
    "content": {
      "episode": 12
    }
  }
}

Common mistakes

Sending a combined code such as "S04E12" or the string "12". The field is an integer, so typed parsers reject the request or drop the value.
Sending an episode number without Content.series, which leaves buyers unable to tell which show it belongs to.

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	integer	No	No
2.3 to 2.3.1	integer	No	No
2.4	integer	No	No
2.5 to 2.6-202606	integer	No	No