Ativar a medição de conversões

A medição da atribuição de conversão pode envolver várias partes, desde o publisher, o anunciante, a adtech de veiculação (a entidade que entrega o anúncio), o provedor de medição e muito mais. Neste documento, ilustramos cenários comuns de medição de conversão, mas, em geral, qualquer parte que queira receber um relatório de atribuição da API Attribution Reporting (ARA) precisa seguir as etapas de integração descritas neste documento.

Por exemplo, é comum que um editor tenha uma ou mais adtechs responsáveis por veicular o anúncio. Isso pode incluir partes responsáveis por fornecer a marcação para o criativo, as partes que fornecem a impressão ou o pixel de rastreamento no criativo e as partes que fornecem o SDK ou a tag para o espaço do anúncio na página do editor. Essas adtechs podem ou não querer receber relatórios de atribuição da ARA, mas estão posicionadas para garantir que as adtechs downstream possam receber esses relatórios.

Além disso, o anunciante também pode usar um provedor de medição de conversões terceirizado para atribuição entre redes e outros recursos de geração de relatórios. Os anunciantes usam esses dados para entender o retorno do investimento em publicidade em vários editores e canais únicos. Por isso, é importante que as DSPs ou os servidores de anúncios saibam como ativar a API Attribution Reporting para oferecer suporte a esses casos de uso. Os anunciantes que quiserem usar um terceiro podem continuar fazendo isso, seja usando um provedor de métricas de terceiros ou configurando um servidor interno para registrar e receber relatórios da API.

A API Attribution Reporting permite que várias adtechs registrem fontes de atribuição e acionadores para a mesma impressão ou conversão e recebam relatórios separados da API. Por exemplo, uma DSP pode receber os próprios relatórios de atribuição da API Attribution Reporting e permitir relatórios separados para o provedor de métricas de terceiros do anunciante. Uma adtech precisa registrar as fontes de atribuição e os acionadores para receber relatórios da API. A atribuição é feita entre as fontes e os acionadores que a adtech registrou individualmente com a API.

Cenários comuns de medição de conversões

Nesta seção, vamos examinar dois cenários comuns para a medição de conversões.

Cenário 1: a adtech de veiculação e o provedor de medição de terceiros precisam receber relatórios da API Attribution Reporting

Um anunciante quer atribuir conversões no inventário de anúncios usando um provedor de medição terceirizado, e a tecnologia de publicidade que hospeda o criativo quer atribuir conversões no inventário de anúncios. Isso é comum para DSPs ou servidores de anúncios de anunciantes (servidor de anúncios de terceiros, 3PAS) que fornecem a marcação para criativos de anúncios, realizam os próprios relatórios de atribuição e trabalham com anunciantes que se integram a provedores de medição ou análise de terceiros.

Nesse caso, a adtech de veiculação também é a parte responsável por acionar eventos de clique e impressão na configuração atual. A adtech de veiculação precisa definir o novo attributionsrc nos locais apropriados e verificar se os redirecionamentos estão configurados corretamente. Além disso, tanto a adtech de veiculação quanto o provedor de medição terceirizado precisam verificar se estão inscritos e se os servidores estão prontos para receber e responder às solicitações da API Attribution Reporting.

Uma configuração de campanha típica pode ser assim:

  1. O servidor de anúncios do anunciante (3PAS) fornece a marcação do criativo de anúncio à DSP, que inclui os pixels de rastreamento de impressões e cliques do provedor de medição terceirizado. O servidor de anúncios precisa garantir que attributionsrc esteja incluído na marcação do criativo.

  2. A DSP oferece recursos para adicionar pixels adicionais de medição de impressões e rastreamento de cliques e deve garantir que o attributionsrc esteja incluído na marcação final do criativo do anúncio com o qual está licitando.

Cenário 2: apenas o provedor de medição terceirizado precisa receber relatórios da API Attribution Reporting

Um anunciante quer atribuir conversões no inventário de anúncios usando um provedor de medição terceirizado, mas a adtech que hospeda o criativo não tem requisitos de medição de atribuição. Isso é comum para publishers, SSPs ou servidores de anúncios de publishers que hospedam criativos e não planejam usar os relatórios de atribuição, mas querem ativar a API Attribution Reporting para os parceiros de DSP ou para empresas de inclusão de tag de medição, como servidores de anúncios, provedores de medição ou de análise de terceiros.

Nesse caso, a parte responsável por acionar eventos de clique e impressão na configuração atual precisa adicionar o novo atributo attributionsrc aos criativos e verificar se os redirecionamentos estão funcionando conforme o esperado. Isso depende muito da integração de cada publisher, mas, para eventos de clique, pode ser a SSP, a adtech de veiculação ou o próprio publisher. Para eventos de impressão, geralmente é o provedor de medição terceirizado.

No exemplo de configuração de campanha típico do cenário 1, o servidor de anúncios do editor, a SSP ou o próprio editor talvez só precise verificar se o atributo attributionsrc fornecido pela DSP aparece na página do editor.

Detalhes da implementação

A tabela a seguir descreve as etapas de implementação da API Attribution Reporting em um nível geral:

Etapas Responsabilidade do trabalho Exemplos
Etapa 1: ativar a origem da atribuição para criativos e código de medição atuais A entidade responsável por acionar eventos de impressão ou processar eventos de clique adiciona o atributo attributionsrc. Para eventos de clique, geralmente um comprador (DSP/servidor de anúncios do anunciante) que renderiza o criativo adiciona o atributo.

Para eventos de impressão, a plataforma de demanda (DSP), a plataforma de fornecimento (SSP), o publisher, o servidor de anúncios ou um provedor de medição adiciona o atributo, que depende da configuração do publisher.

Para anúncios em vídeo que usam o formato VAST, o editor e o SDK de vídeo adicionam o atributo.
Etapa 2: ativar os relatórios de atribuição para origens de terceiros Isso funciona imediatamente se você usar um caminho de redirecionamento com redirecionamentos 302.

Se não for possível usar redirecionamentos 302, o atributo attributionsrc poderá ser usado para listar vários servidores de adtech.

 Em geral, desde que o atributo attributionsrc seja adicionado ao criativo, os redirecionamentos de terceiros vão receber as chamadas da API Attribution Reporting.
Etapa 3: configurar respostas para solicitações da API Attribution Reporting Qualquer entidade que queira receber relatórios da API Attribution Reporting O DSP e o provedor de medição de terceiros usado pelo anunciante

Os detalhes de cada etapa dependem de como os criativos são renderizados e veiculados na página do editor e de quais entidades de adtech recebem relatórios enviados pela API Attribution Reporting.

Etapa 1: ativar a origem da atribuição para criativos e código de medição atuais

Na primeira etapa, as origens de atribuição são ativadas.

Como o atributo attributionsrc funciona

O novo atributo attributionsrc especifica para onde as solicitações da API Attribution Reporting serão enviadas. A entidade responsável por acionar eventos de impressão e clique precisa atualizar os criativos com o atributo attributionsrc. O attributionsrc precisa ser adicionado aos eventos de clique e impressão atuais e pode estar vazio ou não.

Para eventos de clique que usam redirecionamentos, o atributo attributionsrc precisa ser adicionado à navegação. Os redirecionamentos 302 após a navegação não precisam adicionar o atributo attributionsrc e serão qualificados para ARA desde que a navegação inicial tenha adicionado attributionsrc.

Quando o attributionsrc está vazio, as solicitações de ARA são enviadas ao URL definido no atributo href da tag de âncora (URL de clique). Quando o atributo attributionsrc é definido, as solicitações de ARA são enviadas ao URL definido no atributo attributionsrc. O URL de clique também está qualificado para registrar origens.

Em geral, use um atributo attributionsrc vazio se o servidor que hospeda o URL de click-through puder receber e responder a solicitações da API Attribution Reporting. Defina seu próprio URL attributionsrc se quiser que as solicitações da API Attribution Reporting sejam enviadas para um servidor diferente.

Exemplo de um atributo attributionsrc vazio:

Sua configuração atual Com integração do ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>

Quando o atributo attributionsrc está vazio, as solicitações da API Attribution Reporting são enviadas ao URL definido pelo atributo href da tag de âncora.

Exemplo de um atributo attributionsrc não vazio:

Sua configuração atual Com integração do ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>

Quando attributionsrc não está vazio, as solicitações da API Attribution Reporting são enviadas ao URL definido pela tag attributionsrc. O URL de clique também está qualificado para registrar origens.

Adicionar attributionsrc para eventos de clique e impressão

  • Eventos de clique:
    • A entidade responsável por adicionar o attributionsrc geralmente é a adtech de veiculação.
    • As tags de âncora com eventos de clique precisam ter um atributo attributionsrc adicionado.
    • Os cliques que usam window.open precisam usar o argumento windowFeatures da chamada window.open para especificar a origem da atribuição.
  • Eventos de impressão:
    • A entidade responsável por adicionar o attributionsrc geralmente é a tecnologia de publicidade veiculadora e os provedores de medição.
    • Os eventos de impressão disparados da tag <img> ou <script> precisam incluir um atributo attributionsrc.
    • Os eventos de impressão que usam a API Fetch precisam incluir um objeto attributionReporting no argumento options transmitido à chamada da API Fetch.

Confira na tabela a seguir o resumo das modificações necessárias para eventos de clique e impressão:

Evento Tag Sua configuração atual Após a integração do ARA
Clique HTML <a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
JavaScript window.open("[CLICKTHROUGH_URL]", "_blank"); window.open("[CLICKTHROUGH_URL]", "_blank", "attributionsrc");
Impressão Tag HTML <img> <img src="[IMPRESSION_URL]"> <img src="[IMPRESSION_URL]" attributionsrc>
Tag HTML <script> <script src="[IMPRESSION_URL]"></script> <script src="[IMPRESSION_URL]" attributionsrc></script>
JavaScript const options = {...}
window.fetch("[IMPRESSION_URL]", options); 		const options = {
  attributionReporting: {
    eventSourceEligible: true,
    triggerEligible: false,
  },
  ...
};
window.fetch("[IMPRESSION_URL]", options);

Ativar o registro da origem de atribuição em um leilão da API Protected Audience

Para medir conversões em leilões da API Protected Audience, em vez de usar attributionsrc, use registerAdBeacon/registerAdMacro e setReportEventDataForAutomaticBeacons/reportEvent para ativar o registro de fontes de atribuição.

Para gerar relatórios de indicadores da API Protected Audience, a função registerAdBeacon está disponível nos worklets de relatórios, e registerAdMacro está disponível no worklet de relatórios de vitórias do comprador. Em seguida, os dados de evento no frame do anúncio podem ser adicionados aos beacons e macros registrados com as funções reportEvent e setReportEventDataForAutomaticBeacons da API Fenced Frame Ads Reporting. Isso permite que os indicadores dos worklets de relatórios da API Protected Audience e a carga útil do evento de frame do criativo do anúncio sejam associados entre si.

O cabeçalho HTTP Attribution-Reporting-Eligible é adicionado à solicitação quando os beacons e as macros são acionados pela chamada reportEvent de um frame ou quando os beacons automáticos são acionados pelo navegador. É possível usar a resposta do beacon para registrar uma origem de atribuição. As solicitações de beacon podem ser redirecionadas para permitir a medição de terceiros.

Para mais detalhes, consulte a seção Suporte para a API Attribution Reporting (em inglês) do explicador da API Fenced Frame Ad Reporting.

Ativar relatórios de atribuição para formatos VAST

O VAST é um formato comum para veicular e medir o inventário de anúncios em vídeo, e muitos dos eventos definidos nesse padrão devem ser considerados eventos de origem em potencial qualificados para registro com a API Attribution Reporting. O Anexo do VAST para suporte a relatórios de atribuição aborda isso em detalhes, mas, em resumo, todos os eventos <Tracking>, <Impression>, <*ClickThrough> e <*ClickTracking> são possíveis eventos de origem de atribuição. Todas as implementações de VAST precisam oferecer cobertura de qualificação para registro desses eventos.

O complemento VAST define novos atributos para esses elementos, permitindo a configuração de um URL secundário especificamente para o registro de atribuição. Quando um evento contém attributiontype="DOUBLE_PING" e attributionsrc="[URL]", o código que aciona esse evento precisa usar [URL] como o valor do atributo attributionsrc ao ativar a API Attribution Reporting. O apêndice do VAST contém exemplos para cada cenário.

Para maximizar a cobertura, as implementações de VAST precisam, por padrão, tornar todos os eventos listados qualificados para registro quando os pings de eventos são disparados. Por exemplo, ao acionar um URL de evento <Impression>, o atributo attributionsrc (vazio) precisa ser usado no elemento <img> usado para enviar a solicitação (ou o equivalente na chamada de busca) para sempre permitir que a parte receptora registre esse evento com a API Attribution Reporting.

Etapa 2: ativar os relatórios de atribuição para origens de terceiros

Para permitir que terceiros usem a API Attribution Reporting, use redirecionamentos atuais ou adicione uma lista de terceiros ao atributo attributionsrc. Na maioria dos casos, cada adtech tem seu próprio rastreador de impressões independente. Por isso, os redirecionamentos são mais relevantes para rastreadores de cliques.

Processar origens de terceiros em uma cadeia de redirecionamento atual

Em um clique de anúncio típico, muitos rastreadores de cliques podem estar presentes como uma cadeia de redirecionamentos 302 feitos como parte da navegação até a página de destino final. Todas as solicitações na cadeia de redirecionamento estão qualificadas para registro com a API Attribution Reporting se o destino do clique original foi anotado com attributionsrc ou registrado com registerAdBeacon/registerAdMacro na API Protected Audience. A adtech na cadeia de redirecionamento também precisa estar inscrita.

O corpo da solicitação inicial não é enviado em redirecionamentos. Para leilões com Protected Audience, se eventData for transmitido para reportEvent e setReportEventDataForAutomaticBeacons precisar ser usado como parte do redirecionamento, ele precisará ser transmitido explicitamente como parte do URL de redirecionamento.

No exemplo a seguir, vamos usar uma adtech de veiculação (serving-adtech.example) e um provedor de medição de terceiros (3p-measurement.example) como duas entidades distintas que querem gerar e receber relatórios de atribuição. A adtech veiculadora neste exemplo pode ser uma DSP que renderiza o criativo no site do publisher e tem um produto de relatórios próprio. O provedor de medição terceirizada pode ser uma entidade usada pelo anunciante para gerar relatórios de conversão.

Um diagrama que descreve como o proprietário registra a origem.
Exemplo de como a medição de conversões funciona com um terceiro.

No momento do registro da fonte, as seguintes etapas são realizadas:

  1. serving-adtech.example define o atributo attributionsrc no criativo. O usuário acessa a página do editor, e o navegador envia uma solicitação para serving-adtech.example..
  2. O serving-adtech.example responde com os cabeçalhos Attribution-Reporting-Register-Source e Location.
    1. O serving-adtech.example usa o cabeçalho Attribution-Reporting-Register-Source para responder com metadados sobre a origem a ser registrada.
    2. serving-adtech.example usa o cabeçalho Location para incluir um redirecionamento para 3p-measurement.example. É provável que o cabeçalho Location já esteja sendo usado nos fluxos de rastreamento de cliques atuais para oferecer suporte a redirecionamentos 302 para terceiros.
  3. O navegador recebe a resposta de serving-adtech.example e analisa o cabeçalho Attribution-Reporting-Register-Source. O navegador armazena o evento de origem usando serving-adtech.example como a origem de relatórios.
  4. Como essa solicitação é um redirecionamento, o navegador também faz uma nova solicitação para 3p-measurement.example.
  5. O 3p-measurement.example responde com uma resposta que contém o cabeçalho Attribution-Reporting-Register-Source.
  6. O navegador recebe essa resposta de 3p-measurement.example e lê o Attribution-Reporting-Register-Source. O navegador armazena o evento de origem usando 3p-measurement.example como a origem de relatórios.

Use attributionsrc para origens de terceiros que não estão em uma cadeia de redirecionamento

Se várias origens de relatórios quiserem registrar uma fonte em um evento de navegação, mas não puderem aparecer em uma cadeia de redirecionamento por qualquer motivo, liste vários sites como fontes de atribuição em attributionsrc como uma solução alternativa.

Sua configuração atual Com modificação de ARA
<a href="[CLICKTHROUGH_URL]">...</a> <a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]">...</a>

Neste exemplo, as solicitações qualificadas para a API Attribution Reporting serão enviadas para REPORTING_URL_1 e REPORTING_URL_2. A solicitação de navegação enviada ao URL de clique também está qualificada para registrar fontes de atribuição.

Etapa 3: configurar respostas para solicitações da API Attribution Reporting

Para todas as origens que recebem uma solicitação da API Attribution Reporting, verifique se o servidor responde com o cabeçalho Attribution-Reporting-Register-Source adequado. Consulte o guia Registrar fontes e a explicação para saber como a resposta deve ser construída.

Registrar vários acionadores

É possível registrar vários acionadores de atribuição adicionando vários elementos de pixel no lado da conversão (um por acionador). O elemento attributionsrc é opcional para o registro de acionamento.

Também é possível registrar vários acionadores de um único elemento de pixel usando solicitações de redirecionamento ou listando vários URLs no elemento attributionsrc da mesma forma que para o registro de origem. Os eventos de origem e de acionamento gerados pelas mesmas origens serão correspondentes.