Ativar a medição de conversões

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

A medição da atribuição de conversões pode envolver várias partes, como o editor, o anunciante, a adtech de veiculação (a entidade que veicula o anúncio), o provedor de medição e muito mais. Neste documento, ilustramos cenários comuns de medição de conversões, 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 pela veiculação do anúncio, como as partes responsáveis por fornecer a marcação do 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 de terceiros para atribuição em várias redes e outros recursos de relatórios. Os anunciantes usam esses dados para entender o retorno do investimento em publicidade em vários editores e canais exclusivos. Portanto, é importante que os DSPs ou servidores de anúncios saibam como ativar a API Attribution Reporting para esses casos de uso. Os anunciantes que quiserem terceirizar a medição podem continuar fazendo isso usando um provedor de medição terceirizado ou configurando um servidor interno para registrar e receber relatórios da API.

A API Attribution Reporting permite que várias adtechs registrem acionadores e fontes de atribuição para a mesma impressão ou conversão e recebam relatórios separados da API. Por exemplo, um 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 e os acionadores de atribuição para receber relatórios da API. A atribuição é feita entre as fontes e os acionadores registrados individualmente pela adtech na API.

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

Nesta seção, vamos examinar dois cenários comuns de 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 de terceiros, e a adtech 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 (servidores de anúncios de terceiros: 3PAS) que fornecem a marcação para criativos de anúncios, executam os próprios relatórios de atribuição e trabalham com anunciantes que se integram a provedores de análise ou medição 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 adequados e garantir que os redirecionamentos estejam configurados corretamente. Além disso, a adtech de veiculação e o provedor de medição terceirizado precisam garantir que estão cadastrados e que 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 do anúncio ao 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 seja incluído na marcação do criativo do anúncio.

2. A DSP oferece recursos para adicionar impressões de medição adicionais e pixels de rastreamento de cliques, e deve garantir que attributionsrc esteja incluído na marcação final do criativo do anúncio com a 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 de terceiros, mas a adtech que hospeda o criativo não tem requisitos de medição de atribuição. Isso é comum para editores, SSPs ou servidores de anúncios de editores que hospedam criativos e não planejam usar os relatórios de atribuição, mas querem ativar a API Attribution Reporting para parceiros de DSP ou empresas de inclusão de tags de medição, como servidores de anúncios de terceiros, provedores de medição ou análise.

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 garantir que os redirecionamentos estejam funcionando conforme o esperado. Isso depende muito da integração de cada editor, mas, para eventos de clique, pode ser o SSP, a adtech de veiculação ou o próprio editor. Para eventos de impressão, isso 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 pode precisar apenas garantir que o atributo attributionsrc fornecido pela DSP chegue à página do editor.

Detalhes da implementação

A tabela a seguir descreve as etapas de implementação da API Attribution Reporting de modo geral:

Etapas	Responsabilidade do trabalho	Exemplos
Etapa 1: ativar a fonte de atribuição para criativos e códigos de medição atuais	A entidade responsável por disparar 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 editor, o servidor de anúncios ou um provedor de medição adicionam o atributo, que depende da configuração do editor. 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 adtechs.	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	A DSP e o provedor de medição de terceiros usado pelo anunciante

As especificidades 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 fonte de atribuição para criativos e códigos de medição atuais

Na primeira etapa, as fontes 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 de 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 a ARA, desde que a navegação inicial tenha adicionado attributionsrc.

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

Em geral, use um atributo attributionsrc vazio se o servidor que hospeda o URL de clique 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 para o URL definido pelo atributo href da tag â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 o attributionsrc não está vazio, as solicitações da API Attribution Reporting são enviadas para o URL definido pela tag attributionsrc. O URL de clique também pode ser usado 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 adtech de veiculação e os provedores de medição.
  • Os eventos de impressão acionados pela 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 para a 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 de público-alvo protegido, em vez de usar attributionsrc, você pode usar registerAdBeacon/registerAdMacro e setReportEventDataForAutomaticBeacons/reportEvent para ativar o registro de origens de atribuição.

Para informar 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ória do comprador. Em seguida, os dados do evento dentro do 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 o payload do evento do 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 fonte de atribuição. As solicitações de beacon podem ser redirecionadas para permitir a medição de terceiros.

Para saber mais, consulte a seção Suporte para relatórios de atribuição do explicativo 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. Muitos dos eventos definidos nesse padrão precisam ser considerados eventos de origem em potencial qualificados para registro na API Attribution Reporting. O Apêndice do VAST para suporte a relatórios de atribuição aborda esse assunto 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 do VAST precisam oferecer cobertura de qualificação de registro para esses eventos.

O adendo VAST define novos atributos para esses elementos, permitindo a definiçã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 dispara esse evento precisa usar [URL] como o valor do atributo attributionsrc ao ativar a API Attribution Reporting. O apêndice VAST contém exemplos para cada cenário.

Para garantir a cobertura máxima, as implementações do VAST precisam fazer com que todos os eventos listados sejam qualificados para registro por padrão ao disparar pings de evento. Por exemplo, ao disparar 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 que a parte receptora possa registrar 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, então os redirecionamentos são mais relevantes para rastreadores de cliques.

Processar origens de terceiros em uma cadeia de redirecionamento

Em um clique em 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 são qualificadas para registro na 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 cadastrada.

O corpo da solicitação inicial não é enviado em redirecionamentos. Para leilões da 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 de veiculação nesse exemplo pode ser um DSP que renderiza o criativo no site do editor e tem o próprio produto de relatórios. O provedor de medição terceirizado pode ser uma entidade que o anunciante usa para gerar relatórios de conversão.

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. serving-adtech.example responde com o cabeçalho 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 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 do relatório.
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 do 3p-measurement.example e lê o Attribution-Reporting-Register-Source. O navegador armazena o evento de origem, usando 3p-measurement.example como a origem do relatório.

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

Se várias origens de repórter quiserem registrar uma origem em um evento de navegação, mas não puderem aparecer em uma cadeia de redirecionamento por qualquer motivo, você pode listar vários sites como fontes de atribuição em attributionsrc como uma solução alternativa.

Sua configuração atual	Com modificação do 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 pode 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 o explicador 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 acionadores.

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 no registro de origem. Os eventos de origem e de gatilho gerados pelas mesmas origens serão associados.