Como parte do Sandbox de privacidade, o Chrome propôs a versão experimental API Topics. A A API Topics fornece autores de chamadas de terceiros na página da Web (incluindo adtechs) provedores) com tópicos de publicidade gerais que o visitante da página no momento. Os temas podem complementar as informações contextuais sobre a página atual e podem ser úteis para dar suporte a publicidade.
O experimento da API Topics está disponível para parceiros de RTB em solicitações de lance. Os tópicos são enviados a todos os parceiros de RTB com base em disponibilidade.
Representação da solicitação de lance
Protocolo OpenRTB
Os tópicos são representados como segmentos no OpenRTB BidRequest.user.data
mensagem.
Campo | Tipo | Descrição |
---|---|---|
Data.ext.segtax
|
Número inteiro | O ID de uma taxonomia registrada centralmente. Para a API Topics, essa é a versão da taxonomia de publicidade que define o significado semântico de cada ID de tema. O código 600 é usado para a taxonomia inicial da API Topics do Chrome. |
Data.ext.segclass
|
String | É equivalente a classifier_version .
|
Data.segment.id
|
String | Equivalente a id transmitido para uma string.
|
Data.ext
é uma extensão da mensagem BidRequest.user.data
. Esta extensão
está disponível na versão Beta aberta do protocolo.
Aqui está a definição:
// 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 RTB do Google (descontinuado)
Os tópicos são representados no campo topics
na mensagem BidRequest
. Isso
está disponível na versão Beta aberta do protocolo.
Aqui está a definição:
// 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;
Exemplos
Confira a seguir um exemplo de como o Google Authorized Buyers e o OpenRTB Os protocolos representam os temas retornados pela API Topics do Chrome.
Resposta da API Chrome Topics, retornada por 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
}
]
BidRequest
do OpenRTB:
{
"user": {
"data": [
{
"ext": {
"segtax": 600,
"segclass": "classifier_v1"
},
"segment": [
{ "id": "3" },
{ "id": "44" },
{ "id": "59" }
]
}
]
}
}
Protocolo RTB do Google (descontinuado) 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"
}
No exemplo da API Topics do Chrome acima, taxonomy_version
implica que
mapeamento taxonomia_v1
é usado. Com base na taxonomia, esses IDs de temas correspondem aos seguintes
tópicos:
ID do tópico | Valor do tópico |
---|---|
3 | /Artes e Entretenimento/Quadrinhos |
44 | /Artes e Entretenimento/Ópera |
59 | /Automóveis e veículos/Veículos clássicos |
Disponibilidade
A presença de tópicos na solicitação de lance está sujeita à política de privacidade existente e controles de segurança. Por exemplo, os temas ficarão indisponíveis se o usuário permitir da publicidade personalizada anúncios não personalizados inventário.