Google's Topics API provides the functionality to include interest-based user information in bid requests using something called topics without the use of cookies in Chrome when Media Owners are integrated with Index using Prebid.js version 8.9.0 or later. The topics are selected from an advertising taxonomy based on the IAB Audience Taxonomy. When provided, Index sends the following topic information in the user.data.ext and user.data[].segment objects in the bid requests that we send to DSPs.
Note: Index will start sending these fields in December 2023.
| Field | Type | Description |
|---|---|---|
user.data.name | String; required | The exchange-specific name for the data provider that observed the topic IDs. If Index observed the topic IDs, the name will always be topics.indexexchange.com.
|
user.data.ext.segclass | String; required | The taxonomy version of the taxonomy specified in the Taxonomy V1: https://github.com/patcg-individual-drafts/topics/blob/main/taxonomy_v1.md Taxonomy V2: https://github.com/patcg-individual-drafts/topics/blob/main/taxonomy_v2.md |
| Integer; required | The ID associated with the taxonomy specified in the IAB Tech Lab in Enumeration of Taxonomies. Index supports the following taxonomy for the Topics API for Privacy Sandbox: |
| String; required | The ID is the topic ID mapped to the version specified in the |
The following shows what topic data looks like in a bid request:
{
...
"user": {
"data": [{
"name": "topics.indexexchange.com", // Exchange-specific name for the data provider that observed the topic ID
"ext": {
"segtax": 600, // Taxonomy Mapping to V1
"segclass": "1" // Model Mapping
},
"segment": [{
"id": "10"// Topic ID
}]
},
{
"name": "topics.indexexchange.com", // Exchange-specific name for the data provider that observed the topic ID
"ext": {
"segtax": 601, // Taxonomy Mapping to V2
"segclass": "2" // Model Mapping
},
"segment": [{
"id": "12" // Topic ID
}]
}
]
}
}
For more information, refer to the Topics Integration Guide for SSPs.
