BidRequest.cattax
The category taxonomy used by BidRequest.bcat and BidRequest.acat, as a value from the AdCOM Category Taxonomies list. Defaults to 1, IAB Content Category Taxonomy 1.0. Added in 2.6.
Field facts
- Path
cattax- Object
- BidRequest
- Type
- integer
- Default
1- Requirement
- Optional
- Added
- OpenRTB 2.6-202204
- Values
- AdCOM list Category Taxonomies
- Spec section
- 3.2.1
How it is used
Other values include 2 for Content Taxonomy 2.0, 3 and 8 for Ad Product Taxonomy 1.0 and 2.0, and 7 for Content Taxonomy 3.0. The Ad Product Taxonomy was built to classify advertisers, which makes it the closer fit for advertiser category lists. Values of 500 and above are reserved for vendor-specific taxonomies.
Allowed values
| Value | Meaning |
|---|---|
1 | IAB Tech Lab Content Category Taxonomy 1.0: The original IAB content categories with codes like IAB1-1; deprecated, but still the default when cattax is omitted. |
2 | IAB Tech Lab Content Category Taxonomy 2.0: Content Taxonomy 2.0, the first version with numeric IDs; deprecated in favor of later releases. |
3 | IAB Tech Lab Ad Product Taxonomy 1.0: Categories for the product or service an ad promotes, used for ad blocking and creative labeling. |
4 | IAB Tech Lab Audience Taxonomy 1.1: Audience Taxonomy 1.1, which describes people (demographics, interests, purchase intent) rather than content or ads. |
5 | IAB Tech Lab Content Taxonomy 2.1: Content Taxonomy 2.1, a 2.x revision suitable for content classification. |
6 | IAB Tech Lab Content Taxonomy 2.2: Content Taxonomy 2.2, the newest 2.x version in this list. |
7 | IAB Tech Lab Content Taxonomy 3.0: Content Taxonomy 3.0, the first release of the 3.x generation. |
8 | IAB Tech Lab Ad Product Taxonomy 2.0: Ad Product Taxonomy 2.0, the newer of the two ad product versions in this list. |
9 | IAB Tech Lab Content Taxonomy 3.1: Content Taxonomy 3.1, also the default taxonomy for Content.genres when Content.gtax is absent. |
500+ | Vendor-specific codes: Vendor-specific taxonomies, such as an exchange's own category codes, agreed between the parties. |
Example
Where the field sits in a payload, with everything else left out:
{
"id": "req-1",
"cattax": 1
}Common mistakes
Version history
Added in OpenRTB 2.6-202204, 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-202204 | Added in the first 2.6 release, published without a structured text archive; the 2.6-202210 republication is the first tagged text. | ||
| 2.6-202210 to 2.6-202606 | integer, default 1 | No | No |
Related fields
Other BidRequest fields
For a walkthrough of the whole object, read Bid request anatomy.