Ativar a medição de conversões

A medição da atribuição de conversões pode envolver várias partes, incluindo o editor, o anunciante, a adtech 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. No entanto, as partes que quiserem receber um relatório da API Attribution Reporting (ARA, na sigla em inglês) precisarão 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 as partes responsáveis pelo fornecimento da 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 terceirizado para a atribuição de várias redes, além de outros recursos 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 servidores de anúncios entendam 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 com 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, uma DSP pode receber os próprios relatórios de atribuição da API Attribution Reporting, além de permitir relatórios separados para o provedor de medição terceirizado do anunciante. Uma adtech precisa registrar os acionadores e as fontes de atribuição para receber relatórios da API. A atribuição é feita entre as fontes e os acionadores registrados individualmente pela API.

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

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

Cenário 1: as adtechs que veiculam anúncios e o provedor de medição terceirizado 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 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 (servidor de anúncios de terceiros – 3PAS) que fornecem a marcação para criativos de anúncios, realizam seus próprios relatórios de atribuição e trabalham com anunciantes que se integram a provedores terceirizados de medição ou análise.

Nesse caso, a adtech também é responsável por acionar eventos de cliques e impressões na configuração atual. A adtech precisa definir o novo attributionsrc nos locais adequados e garantir que os redirecionamentos estejam configurados corretamente. Além disso, a adtech que veicula anúncios e o provedor de medição terceirizado precisam estar registrados 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 ter esta aparência:

1. O servidor de anúncios do anunciante (3PAS) fornece a marcação do criativo do anúncio para a DSP, que inclui a impressão do provedor de medição terceirizado e pixels de rastreamento de cliques. O servidor de anúncios precisa garantir que attributionsrc esteja 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 precisa garantir que attributionsrc esteja incluído na marcação final do criativo de anúncio final com que estão fazendo lances.

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

Um anunciante quer atribuir conversões em um 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 editores, SSPs ou servidores de anúncios do editor 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 para empresas de inclusão de tags de medição, como servidores de anúncios terceirizados, provedores de medição ou análise.

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

No exemplo típico de configuração de campanha do cenário 1, o servidor de anúncios do editor, a SSP ou o próprio editor talvez só precise garantir que o atributo attributionsrc fornecido pelo DSP chegue à página do editor.

Detalhes da implementação

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

Passos	Responsabilidade do trabalho	Exemplos
Etapa 1: ativar a fonte de atribuição para os criativos e o código 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 (servidor de anúncios de DSP/anunciante) que renderiza o criativo adiciona o atributo. Para eventos de impressão, uma plataforma de demanda (DSP), uma plataforma de fornecimento (SSP), um editor, um servidor de anúncios ou um provedor de medição adiciona o atributo, e ele 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 a API Attribution Reporting para origens de terceiros	Isso funciona imediatamente se você usar um caminho de redirecionamento existente com redirecionamentos 302. Se os redirecionamentos 302 não puderem ser usados, o atributo attributionsrc poderá ser usado para listar vários servidores de adtechs.	Geralmente, 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 terceirizado usado pelo anunciante

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

Importante :o provedor de medição terceirizado precisa garantir que está registrado e que os servidores dele estão prontos para receber e responder às solicitações da API Attribution Reporting.

Etapa 1: ativar a fonte de atribuição para os criativos e o código 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 disparar 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 estarão qualificados para a ARA, desde que a navegação inicial tenha adicionado attributionsrc.

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

Geralmente, use um atributo attributionsrc vazio se o servidor que hospeda o URL de clique puder receber e responder às solicitações da API Attribution Reporting. Defina seu próprio URL do attributionsrc se quiser que as solicitações da API Attribution Reporting sejam direcionadas para um servidor diferente.

Exemplo de um atributo attributionsrc vazio:

Sua configuração atual	Com integração com 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 âncora.

Exemplo de um atributo Attributionsrc não vazio:

Sua configuração atual	Com integração com 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 serão enviadas ao URL definido pela tag attributionsrc. O URL de clique também é 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 responsável.
  • As tags â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 fonte de atribuição.
• Eventos de impressão:
  • A entidade responsável por adicionar o attributionsrc geralmente é a adtech responsável e os provedores de medição.
  • Os eventos de impressão disparados 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.

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

Evento	Tag	Sua configuração atual	Após a integração com 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 fonte de atribuição em um leilão da API Protected Audience

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

Para gerar relatórios sobre indicadores de Protected Audience, a função registerAdBeacon está disponível nos worklets de relatórios, e registerAdMacro está disponível dentro do worklet de relatórios de vitórias do comprador. Em seguida, os dados de eventos no frame do anúncio podem ser adicionados aos beacons e às 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 uns aos outros.

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 os beacons automáticos são acionados pelo navegador. Você pode 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.

Observação: a API Fenced Frame Ads Reporting está disponível em um iframe e em um frame isolado.

Para saber mais, consulte a seção Suporte à API Attribution Reporting na explicação da API Fenced Frame Ad Reporting.

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

O VAST é um formato comum para veicular e avaliar inventário de anúncios em vídeo, e muitos dos eventos definidos nesse padrão devem ser considerados possíveis eventos de origem qualificados para registro com a API Attribution Reporting. O Adendo VAST para suporte à API Attribution Reporting aborda esse assunto em detalhes, mas, em resumo, todos os eventos <Tracking>, <Impression>, <*ClickThrough> e <*ClickTracking> são possíveis eventos da fonte de atribuição. Todas as implementações de VAST precisam fornecer cobertura de qualificação para inscrição nesses eventos.

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

Para garantir a máxima cobertura, as implementações de VAST precisam tornar todos os eventos listados 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 sempre permitir que a parte receptora registre esse evento com a API Attribution Reporting.

Etapa 2: ativar a API Attribution Reporting para origens de terceiros

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

Processar origens de terceiros em uma cadeia de redirecionamento existente

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

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

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

No momento do registro da fonte, as seguintes etapas ocorrem:

1. serving-adtech.example define o atributo attributionsrc no criativo. O usuário visita a página do editor, e o navegador envia uma solicitação para serving-adtech.example..
2. 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. O 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 do relatório.
4. Como essa solicitação é um redirecionamento, o navegador também faz uma nova solicitação para 3p-measurement.example.
5. 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 do relatório.

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

Se várias origens de relator 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 da 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.

Aviso: essas solicitações são enviadas apenas em navegadores compatíveis com a API Attribution Reporting e podem ser perdidas em ambientes sem suporte.

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 apropriado. Consulte o guia Fontes de registro e a explicação para saber como a resposta deve ser construída.

Registrar vários gatilhos

Você pode registrar vários acionadores de atribuição adicionando diversos 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 a partir 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 da origem. Os eventos de origem e de acionador que foram gerados pelas mesmas origens serão correspondidos.