Guia de integração da API Topics para SSPs

Como parte do Sandbox de privacidade, o Chrome propôs um Tópicos API. Tópicos A API fornece autores de chamadas de terceiros na página da Web (incluindo provedores de adtech) com publicidade geral tópicos que podem interessar os visitantes da página. Esses tópicos podem complementam as informações contextuais sobre a página atual.

Rede de Display e A Video 360 e o Google Ads consideraram a API Topics um indicador valioso na combinação com outros sinais na exibição de publicidade com base em interesses, sem e depender de cookies de terceiros. Saiba mais. sobre o Display & Abordagem do Video 360 e do Google Ads para publicidade com base em interesses. O Google incentiva as SSPs a incluir a Topics nos pedidos para ajudar a aumentar a relevância do inventário do editor.

Este guia mostra as etapas necessárias para a integração das SSPs Topics e para testá-los com o Display & o Video 360 e o Google Ads ou qualquer outro provedor de adtech participante.

Informações gerais

Antes de conhecer a API Topics, conheça com o guia para desenvolvedores da Topics do Chrome. A partir de outubro de 2023, o Chrome vai exigir que os autores de chamadas de APIs do Sandbox de privacidade, incluindo a Topics, se inscrevam. Para conferir mais informações e atualizações mais recentes, confira a página de status da API Topic do Chrome e Atualizações mais recentes da API Topics.

Métodos de acesso a tópicos

Confira um resumo dos métodos mais comuns de acessar a API Topics. Se esses métodos não funcionarem para sua configuração, o DV360 recomenda que você entre em contato com a equipe do Chrome de acordo com os canais sugeridos descritos na página Status da API Topic do Chrome.

Implementação direta

As SSPs podem solicitar temas nas páginas dos parceiros editores usando JavaScript (documentação). ou cabeçalhos (documentação).

Como usar o módulo Prebid

As SSPs que participam do Prebid podem consultar o Documentação do Prebid para saber como receber tópicos usando topicsFpdModule. Como os editores precisam incluir esse módulo no pacote final do prebid, O DV360 incentiva você a entrar em contato com seus parceiros editores para ter se esse requisito está no radar deles.

Como usar o Prebid 8.9.0+

O Prebid lançou um novo recurso nos módulos principais do Prebid 8.9.0+ que permitem que a API Topics seja chamada em solicitações de lance enviadas. [notas da versão]. Documentação do Prebid descreve como incluir os tópicos de navegação na resposta do servidor. Os tópicos estão disponíveis na tabela "Sec- Browsing-Topics" cabeçalho da solicitação fetch(). As SSPs talvez precisem transferir os temas do cabeçalho à solicitação de lance antes de enviá-la ao DV360. Como os editores precisam ter a versão 8.9.0 ou mais recente implementada, para que essa capacidade esteja disponível, certifique-se de que seus parceiros editores saibam disso.

Como usar o Open Bidding

SSPs que participam do Open Bidding consulte a documentação do Authorized Buyers receber Topics em solicitações de lance do Google usando o protocolo OpenRTB.

Como transmitir tópicos para o DV360 e o Google Ads

A seção anterior delineou as opções para acessar a API Topics. Depois de acessar os Tópicos, você pode compartilhá-los no fluxo de lances com seus compradores da DSP. Esta seção descreve como passar para o DV360 e o Google Ads. O DV360 e o Google Ads esperam que a Topics seja no objeto user.data em OpenRTBRequest. Saiba como transmitir IDs de segmento em taxonomias específicas de fornecedores usando JSON.

Exemplo

Resposta da API Chrome Topics, retornada por document.browsingTopics():

[
  {
    "modelVersion": "classifier_v2",
    "taxonomyVersion": "taxonomy_v2",
    "topic": 351
  },
  {
    "modelVersion": "classifier_v2",
    "taxonomyVersion": "taxonomy_v2",
    "topic": 163
  },
  {
    "modelVersion": "classifier_v2",
    "taxonomyVersion": "taxonomy_v2",
    "topic": 59
  }
]

JSON OpenRTBRequest:

{
  ...
  "user": {
    "data": [
      {
        "ext": {
          "segtax": 601,
          "segclass": "classifier_v1"
        },
        "segment": [
          { "id": "351" },
          { "id": "163" },
          { "id": "59" }
        ]
      }
    ]
  }
}

No exemplo anterior, taxonomy_version implica que taxonomia_v2 mapeamento é usado. Com base na taxonomia, esses IDs de temas correspondem aos seguintes Tópicos:

ID do tópico Valor do tópico
351 /Artes e entretenimento/Quadrinhos e animação
163 /Finanças/Seguros/Seguro de viagem
59 /Automóveis e veículos/Veículos clássicos