Como parte de Privacy Sandbox, Chrome propuso la API de Topics experimental. La API de Topics proporciona llamadores externos en la página web (incluidos los proveedores de tecnología publicitaria) con temas publicitarios generales que podrían interesarle al visitante de la página. 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 socios de RTB en solicitudes de oferta. Completa el formulario de solicitud para unirte al experimento de la API de Topics. Comunícate con tu administrador de cuentas para obtener más información.
Representación de una solicitud de oferta
Protocolo de Google Authorized Buyers
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;
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 se registró de manera centralizada. Para Topics, esta es la versión de la taxonomía de publicidad 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
|
Cadena | Equivale a classifier_version.
|
Data.segment.id
|
Cadena | Equivale a id convertido en una string.
|
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;
}
Ejemplos
El siguiente es un ejemplo de cómo los protocolos de OpenRTB y Google Authorized Buyers representan los temas que muestra la API de Topics de Chrome.
Respuesta de la API de Topics de Chrome que muestra 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
}
]
Protocolo BidRequest del protocolo Google Authorized Buyers:
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"
}
OpenRTB BidRequest:
{
"user": {
"data": [
{
"ext": {
"segtax": 600,
"segclass": "classifier_v1"
},
"segment": [
{ "id": "3" },
{ "id": "44" },
{ "id": "59" }
]
}
]
}
}
En el ejemplo anterior, taxonomy_version implica que se usa la asignación taxonomy_v1. Según la taxonomía, estos ID de tema corresponden a los siguientes temas:
| ID del tema | Valor del tema |
|---|---|
| 3 | /Arts & Entertainment/Cómics |
| 44 | /Arte y entretenimiento/Ópera |
| 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 estarán disponibles si el usuario inhabilita la publicidad personalizada o el inventario de anuncios no personalizados.