Guia de integração da API Protected Audience (antes conhecida como FLEDGE) para provedores de medição

Como parte do Sandbox de privacidade, o Chrome propôs API Protected Audience API: uma API no navegador que permite que anunciantes e empresas de adtech mostrem anúncios segmentados por grupo de interesse sem depender de cookies de terceiros e, ao mesmo tempo, proteger os usuários monitoramento.

Na API Protected Audience, quando um anúncio de remarketing vence o leilão, a o URL do anúncio será enviado para um grupo de entrada Frame para renderização. Um frame isolado é um elemento HTML proposto para conteúdo incorporado, semelhante a um iframe. Ao contrário dos iframes, um frame isolado restringe a comunicação com o contexto de embedding para permitir que o frame acesse dados entre sites sem compartilhando com o contexto de embedding. Para mais detalhes, consulte a Casos de uso de Fenced Frames de explicação.

Rede de Display e O Video 360 é compatível com uma lista de macros para medição provedor usar no rastreamento de impressões e cliques. Apenas um pequeno subconjunto dessas podem ser substituídas como parte da renderização do criativo devido à falta de e indicadores de leilão. Por exemplo, ${PUBLISHER_ID} terá falhas sem mudanças às tags do provedor de medição.

Este guia foi criado para parceiros de medição de anúncios que acompanham eventos para anunciantes que usar as campanhas de display Vídeo em 360°.

Registro

A partir de agosto de 2023, os provedores de medição talvez precisem seguir as etapas abaixo. abaixo para se registrarem para usar as APIs Fenced Frame Reporting na API Protected API Audience.

Detalhes sobre como e quem precisará se inscrever

Integração

Tags de impressão do provedor de medição

Instruções de configuração:

Tags de script Exemplo 
<script src='https://tracking.com/a.js'>xxx</script>
 Responsabilidade:os provedores de medição precisam atualizar as tags de script para serem usadas. API reportEvent para rastreamento de impressões (consulte a orientação) abaixo).
Tags de imagem Exemplo 
<img src='https://tracking.com/'>
 Responsabilidade:display e Video 360 vai atualizar as tags img src para uso a API reportEvent para rastreamento de impressões.

API reportEvent

A API foi proposta para ser usada para somente rastreamento pós-renderização. A API contém duas partes: registerAdMacro e reportEvent.

  • Rede de Display e O Video 360 é proprietário da função registerAdMacro em reportWin. A registrará pares de chave-valor de macro no navegador antes da de renderização.
  • Dependendo do tipo de tag, as campanhas O Video 360 ou provedores de medição as mudanças nas tags 3PAT para usar a API reportEvent.

reportEvent usa apenas uma entrada "destinationURL", que aponta aos servidores do provedor de medição. Ele pode conter as macros listadas no Display e Ajuda do Video 360 de Ajuda. Exemplo:

window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

Quando o Chrome dispara o ping de URL na função, ele procura registros e as substitua pelos valores antes de enviar uma solicitação GET HTTP para https://adtech.example:

Etapas para atualizar as tags de script

Não haverá alterações nas tags dos criativos existentes. Rede de Display e Imagem estática do Video 360 Renderiza tags do provedor de medição sem modificação como parte do criativo payload. Quando provedores de medição recebem pings de impressão da rede público-alvo, ele precisará seguir as etapas abaixo para impressão acompanhamento:

  1. Prepare o URL de impressão de um provedor de medição para aceitar os pings de impressão. Exemplo:

    https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123

  2. Adição do JavaScript reportEvent ao responder a um script da API Protected API Audience. Exemplo:

    window.fence.reportEvent({
  'destinationURL': 'https://adtech.example/impression?cid=555&pub_id=${PUBLISHER_ID}&site=${SOURCE_URL_ENC}&t=123'
});

  3. Registra impressões ao receber pings do URL de impressão configurado em etapa 1.

Tags de clique do provedor de medição

A click tag do provedor de medição atual vai continuar funcionando para as impressões da API Protected Audience. Rede de Display e O Video 360 usará os recursos da API Fenced Frames Ads Reporting beacon do reserved.top_navigation para registrar cliques e encadear todos do provedor de medição como redirecionamentos. Para mais detalhes, consulte Documentação do Chrome sobre relatórios de anúncios de frame isolado API.