Content.genres
Genre IDs for the content, taken from the taxonomy named by Content.gtax. When gtax is absent, the IDs come from the CTV Genre Mapping subset of IAB Content Taxonomy 3.1. Added in 2.6-202501.
Field facts
- Path
app.content.genres,dooh.content.genres,site.content.genres- Object
- Content
- Type
- string array
- Requirement
- Optional
- Added
- OpenRTB 2.6-202501
- Spec section
- 3.2.16
How it is used
Its declared type has moved between snapshots: the archived 2.6-202505 table lists a plain string, and 2.6-202606 lists an array of strings. Send an array of string IDs, since Content Taxonomy 3.x IDs are not all numeric, and confirm what partners pinned to older snapshots expect. The implementation guidance for this field pair is Section 7.13 of the IAB guide.
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"app": {
"content": {
"genres": [
"483"
]
}
}
}Common mistakes
- Sending genre names such as "Drama" instead of taxonomy IDs.
- Sending integers instead of strings. The current type is a string array.
- Validating an array against the 2.6-202505 snapshot, whose catalog row expects a single string, and reading the type mismatch as a payload bug. Against 2.6-202606 the array is correct.
Version history
Added in OpenRTB 2.6-202501, 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.6-202501 | Listed in this release's notes; IAB's tagged spec file for it does not include the field yet. | ||
| 2.6-202505 | string | No | No |
| 2.6-202606 | string array | No | No |
Related fields
Other Content fields
albumartistcatcattaxchannelcontentratingcontextdataembeddableepisodeextfirstbroadcastgenregtaxidisrckeywordskwarraylangblanguagelenlivestreamnetworkprodqproducerqagmediaratingrealtimeseasonseriessourcerelationshiptitleurluserratingvideoquality
For a walkthrough of the whole object, read CTV and ad pods.