Como parte de Privacy Sandbox, Chrome propuso la API de Topics experimental. La API de Topics proporciona a los llamadores externos en la página web (incluidos los proveedores de tecnología publicitaria) temas publicitarios generales en los que el visitante de la página podría estar interesado actualmente. Los temas pueden complementar la información contextual sobre la página actual y pueden ser útiles para respaldar la publicidad basada en intereses.
El experimento de la API de Topics está disponible para los socios de RTB en las solicitudes de oferta. Los temas se envían a todos los socios de RTB según la disponibilidad.
Representación de la solicitud de oferta
Protocolo OpenRTB
Los temas se representan como segmentos en el mensaje BidRequest.user.data de OpenRTB.
| Campo | Tipo | Descripción |
|---|---|---|
Data.ext.segtax
|
Número entero | Es el ID de una taxonomía que está registrada de forma centralizada. En el caso de los temas, esta es la versión de la taxonomía publicitaria que define el significado semántico de cada ID de tema. El valor 600 se usa para la taxonomía inicial de Topics de Chrome. |
Data.ext.segclass
|
String | Equivale a classifier_version.
|
Data.segment.id
|
String | Equivale a id convertido en una cadena.
|
Data.ext es una extensión del mensaje BidRequest.user.data. Esta extensión está disponible en la versión beta abierta del protocolo.
Esta es la definición:
// Ad Exchange extensions for the Data object.
message DataExt {
// The ID for a taxonomy that is registered centrally. Used to define the
// namespace and semantic meaning of the segment IDs. See
// https://github.com/InteractiveAdvertisingBureau/openrtb/blob/master/extensions/community_extensions/segtax.md#enumeration-of-taxonomies
// for the enumeration of the taxonomies that this value can take. Currently
// only Chrome Topics API taxonomy (segtax=600) is supported.
optional int32 segtax = 1;
// The version of the classifier which produced the segment IDs within the
// taxonomy. For example, in the case of Chrome Topics API (segtax=600), this
// is the version of the classifier used by the browser to map hostnames to
// topics in the taxonomy.
optional string segclass = 2;
}
Protocolo de RTB de Google (obsoleto)
Los temas se representan en el campo topics del mensaje BidRequest. Este campo está disponible en la versión beta abierta del protocolo.
Esta es la definición:
// Experimental field; subject to change.
// A coarse-grained topic that a website visitor might currently be interested
// in based on recent browsing activity. See
// https://developer.chrome.com/docs/privacy-sandbox/topics/ and/or
// https://privacysandbox.com/intl/en_us/proposals/topics/ for more
// information about the Topics API. Reach out to your account manager to
// participate in the Topics API experiment.
message Topic {
// The value of a topic ID. A numerical identifier corresponding to a
// coarse-grained advertising topic. See
// https://github.com/patcg-individual-drafts/topics/blob/main/taxonomy_v1.md
// for a list of topics in the initial taxonomy.
optional int32 id = 1;
// The version of the advertising taxonomy which defines the semantic
// meaning of each topic ID for the topics, for example "v1".
optional string taxonomy_version = 2;
// The version of the classifier used by the browser to map hostnames to
// topic IDs in the taxonomy.
optional string classifier_version = 3;
}
// The list of topics that a website visitor might currently be interested in
// inferred by the browser based on recent browsing activity. See
// https://developer.chrome.com/docs/privacy-sandbox/topics/ and/or
// https://privacysandbox.com/intl/en_us/proposals/topics/ for more
// information about Topics API.
repeated Topic topics = 74;
Ejemplos
A continuación, se muestra un ejemplo de cómo los protocolos de Google Authorized Buyers y OpenRTB representan los temas que devuelve la API de Chrome Topics.
Respuesta de la API de Topics de Chrome, que devuelve document.browsingTopics():
[
{
"modelVersion": "classifier_v1",
"taxonomyVersion": "taxonomy_v1",
"topic": 3
},
{
"modelVersion": "classifier_v1",
"taxonomyVersion": "taxonomy_v1",
"topic": 44
},
{
"modelVersion": "classifier_v1",
"taxonomyVersion": "taxonomy_v1",
"topic": 59
}
]
OpenRTB BidRequest:
{
"user": {
"data": [
{
"ext": {
"segtax": 600,
"segclass": "classifier_v1"
},
"segment": [
{ "id": "3" },
{ "id": "44" },
{ "id": "59" }
]
}
]
}
}
Protocolo de RTB de Google (obsoleto) BidRequest:
topics {
id: 3
taxonomy_version: "taxonomy_v1"
classifier_version: "classifier_v1"
}
topics {
id: 44
taxonomy_version: "taxonomy_v1"
classifier_version: "classifier_v1"
}
topics {
id: 59
taxonomy_version: "taxonomy_v1"
classifier_version: "classifier_v1"
}
En el ejemplo anterior de la API de Topics de Chrome, taxonomy_version implica que se usa la asignación taxonomy_v1. Según la taxonomía, estos IDs de temas corresponden a los siguientes temas:
| ID del tema | Valor del tema |
|---|---|
| 3 | /Arts & Entertainment/Comics |
| 44 | /Arts & Entertainment/Opera |
| 59 | /Autos & Vehicles/Classic Vehicles |
Disponibilidad
La presencia de temas en la solicitud de oferta está sujeta a las protecciones y los controles de privacidad existentes. Por ejemplo, los temas no están disponibles si el usuario inhabilita la publicidad personalizada o en el inventario de anuncios no personalizados.