Attribution Reporting: visão geral completa do sistema

Visão geral de alto nível dos serviços conectados para o Relatório de atribuição, voltada para tomadores de decisões técnicas.

Com a API Attribution Reporting, as adtechs e os anunciantes podem medir quando um clique ou uma visualização de anúncio gera uma conversão, como uma compra. Essa API depende de uma combinação de integrações do lado do cliente e do servidor, dependendo das suas necessidades comerciais.

Antes de continuar, leia a visão geral dos relatórios de atribuição. Isso vai ajudar você a entender a finalidade da API e o fluxo dos diferentes relatórios de saída (relatório no nível do evento e relatórios de resumo). Se você encontrar termos desconhecidos, consulte o glossário do Sandbox de privacidade.

Para quem é este documento?

Leia este documento se:

  • Você é um responsável por tomar decisões técnicas de uma adtech ou de um anunciante. Você pode trabalhar em operações, DevOps, ciência de dados, TI, marketing ou outra função em que toma decisões de implementação técnica. Você quer saber como as APIs funcionam para medição que preserva a privacidade.
  • Você é um profissional técnico (como um desenvolvedor, operador de sistema, arquiteto de sistema ou cientista de dados) que vai configurar experimentos com esse ambiente de API e serviço de agregação.

Neste documento, você vai ler uma explicação de alto nível e de ponta a ponta sobre como os serviços funcionam para a API Attribution Reporting. Se você é um profissional técnico, pode testar essa API localmente.

Visão geral

A API Attribution Reporting consiste em muitos serviços, que exigem configurações específicas, configurações do lado do cliente e implantações do servidor. Para determinar o que você precisa, primeiro:

  • Tomar decisões de design. Defina as informações que você quer coletar, identifique as conversões esperadas de uma campanha específica e determine qual tipo de relatório coletar. A saída final é um ou os dois tipos de relatório: de eventos e de resumo.

Há sempre dois (e às vezes três) componentes que trabalham juntos para oferecer suporte aos relatórios:

  • Comunicação do site com o navegador. Em sistemas baseados em cookies, as informações de conversões e engajamentos com anúncios são anexadas a um identificador que permite que você ou um serviço de análise junte esses eventos mais tarde. Com essa API, o navegador associa as conversões a cliques/visualizações de anúncios, com base nas suas instruções, antes de serem entregues para análise. Portanto, seu código de renderização de anúncios e o acompanhamento de conversões precisam:
    • Informe ao navegador quais conversões devem ser atribuídas a quais cliques ou impressões de anúncios.
    • Indique outros dados que precisam ser incluídos nos relatórios finais.
  • Coleta de dados. Você vai precisar de um endpoint de coleta para receber os relatórios gerados nos navegadores dos usuários. A saída dos navegadores pode ser um de dois relatórios possíveis: de eventos e agregáveis (criptografados, usados para gerar relatórios de resumo).

Se você coletou relatórios agregáveis, vai precisar de um terceiro componente:

Decisões de design

Um princípio fundamental dos relatórios de atribuição são as decisões de design antecipadas. Você decide quais dados coletar em quais categorias e com que frequência processá-los. Os relatórios gerados oferecem insights sobre suas campanhas ou sua empresa.

O relatório de saída pode ser:

  • Os relatórios de eventos associam um clique ou uma visualização de anúncio específica (no lado do anúncio) a dados do lado da conversão. Para preservar a privacidade do usuário, limitando a junção da identidade do usuário em vários sites, os dados do lado da conversão são muito limitados e ruidosos. Isso significa que, em uma pequena porcentagem de casos, dados aleatórios são enviados em vez de relatórios reais.
  • Os relatórios de resumo não estão vinculados a um evento específico no lado do anúncio. Esses relatórios oferecem dados de conversão mais detalhados e flexibilidade para combinar dados de clique e visualização com dados de conversão.

A seleção de relatórios determina quais dados você precisa coletar.

Também é possível pensar na saída final como uma entrada para as ferramentas que você usa para tomar decisões. Por exemplo, se você gerar relatórios de resumo para determinar quantas conversões resultaram em um valor total de gasto, isso poderá ajudar sua equipe a decidir qual será o público-alvo da próxima campanha publicitária para gerar um gasto total maior.

Depois de decidir o que você quer medir, configure o lado do cliente para a API Attribution Reporting.

Comunicação entre site e navegador

As origens de atribuição no site de um publisher se conectam com os acionadores no site de um anunciante.
As origens de atribuição no site de um publisher se conectam com acionadores no site de um anunciante.

Fluxo de eventos de atribuição

Imagine um site de editor que exibe anúncios. Cada anunciante ou provedor de tecnologia de publicidade quer saber mais sobre as interações com os anúncios e atribuir conversões ao anúncio correto. Os relatórios (no nível do evento e agregáveis) seriam gerados da seguinte forma:

  1. No site do publisher, um elemento de anúncio (tag <a> ou <img>) é configurado com um atributo especial attributionsrc. O valor é um URL, por exemplo, https://adtech.example/register-source/ad_id=....

    Confira um exemplo de link que registra uma origem quando clicado:

    <a href="https://shoes.example/landing"
  attributionsrc="http://adtech.example/register-source?..."
  target="_blank">
Click me</a>

    Confira um exemplo de imagem que vai causar o registro de uma origem quando for visualizada:

    <img href="https://advertiser.example/landing"
  attributionsrc="https://adtech.example/register-source?..."/>

    Como alternativa, em vez de elementos HTML, é possível usar chamadas JavaScript.

    Confira um exemplo em JavaScript usando window.open(). O URL é codificado para evitar problemas com caracteres especiais.

    const encodedUrl = encodeURIComponent(
  'https://adtech.example/attribution_source?ad_id=...');
window.open(
  "https://shoes.example/landing",
  "_blank",
  `attributionsrc=${encodedUrl}`);

  2. Quando o usuário clica ou visualiza o anúncio, o navegador envia uma solicitação GET para attributionsrc, geralmente um endpoint de anunciante ou provedor de adtech.

  3. Ao receber essa solicitação, o anunciante ou provedor de adtech decide instruir o navegador a registrar eventos de origem para interações com o anúncio, de modo que as conversões possam ser atribuídas a ele mais tarde. Para isso, o anunciante ou provedor de adtech inclui um cabeçalho HTTP especial na resposta. Ele anexa a esse cabeçalho dados personalizados que fornecem informações sobre o evento de origem (clique ou visualização do anúncio). Se uma conversão ocorrer para esse anúncio, esses dados personalizados vão aparecer no relatório de atribuição.

    Visualizar ou clicar em um anúncio.

  4. Depois, o usuário visita o site do anunciante.

  5. Em cada página relevante do site do anunciante, por exemplo, uma página de confirmação de compra ou de produto, um pixel de conversão (elemento <img>) ou uma chamada JavaScript faz uma solicitação para https://adtech.example/conversion?param1=...&param2=....

  6. O serviço nesse URL, geralmente o anunciante ou o provedor de adtech, recebe a solicitação. Ele decide categorizar isso como uma conversão e precisa instruir o navegador a registrar uma conversão, ou seja, acionar uma atribuição. Para isso, o anunciante ou provedor de tecnologia de publicidade inclui na resposta à solicitação de pixel um cabeçalho HTTP especial com dados personalizados sobre a conversão.

  7. O navegador no dispositivo local do usuário recebe essa resposta e faz a correspondência dos dados de conversão com o evento de origem original (clique ou visualização do anúncio).

  8. O navegador programa um relatório para ser enviado a attributionsrc. Este relatório inclui:

    1. Os dados de configuração de atribuição personalizada que o anunciante ou provedor de tecnologia de publicidade anexou ao evento de origem na Etapa 3.
    2. O conjunto de dados de conversão personalizada na etapa 6.
    O diagrama mostra os elementos do acionamento da API Attribution Reporting, que resulta em relatórios agregáveis e no nível do evento.
    O diagrama mostra os elementos do acionamento da API Attribution Reporting, que resulta em relatórios no nível do evento e agregáveis.

  9. Depois, o navegador envia os relatórios ao endpoint definido em attributionsrc, com algum atraso e ruído. Os relatórios agregáveis são criptografados, enquanto os de eventos não são.

Acionadores de atribuição (site do anunciante)

O gatilho de atribuição é o evento que informa ao navegador para capturar conversões.

Recomendamos capturar as conversões mais importantes para o anunciante, como compras. Vários tipos de conversão e metadados podem ser capturados em relatórios de resumo.

Isso verifica se os resultados agregados são detalhados e precisos para esses eventos.

Corresponder origens a acionadores

Quando um navegador recebe uma resposta de acionador de atribuição, ele acessa o armazenamento local para encontrar uma origem que corresponda à origem do acionador de atribuição e ao eTLD+1 do URL da página.

Por exemplo, quando o navegador recebe um acionador de atribuição de adtech.example em shoes.example/shoes123, ele procura uma fonte no armazenamento local que corresponda a adtech.example e shoes.example.

É possível definir filtros (ou regras personalizadas) para determinar quando um acionador é correspondido a uma origem específica. Por exemplo, defina um filtro para contar apenas as conversões de uma categoria de produto específica e ignorar todas as outras. Os filtros e modelos de priorização permitem relatórios de atribuição mais avançados.

Se várias fontes de atribuição forem encontradas no armazenamento local, o navegador vai escolher a que foi armazenada mais recentemente. Em alguns casos em que as fontes de atribuição recebem uma prioridade, o navegador seleciona a fonte com a maior prioridade.

Coleta de dados

Juntos, um acionador de atribuição correspondente a uma fonte são enviados como um relatório pelo navegador a um endpoint de relatórios em um servidor de propriedade de uma adtech (às vezes chamado de endpoint ou serviço de coleta). Esses relatórios podem ser de evento ou agregáveis.

Relatórios agregáveis são usados para gerar relatórios de resumo. Um relatório agregável é uma combinação de dados coletados do anúncio (no site de um publisher) e de conversão (no site do anunciante), que é gerada e criptografada pelo navegador no dispositivo de um usuário antes de ser coletada pela adtech.

Os relatórios de evento têm um atraso de 2 a 30 dias. Os relatórios agregáveis são enviados com um atraso aleatório de até uma hora, e os eventos precisam se enquadrar no orçamento de contribuição. Essas escolhas protegem a privacidade e evitam a exploração das ações de qualquer usuário individual.

Se você só tiver interesse em relatórios no nível do evento, essa é a última parte da infraestrutura necessária. No entanto, se você quiser gerar relatórios de resumo, será necessário processar os relatórios agregáveis com um serviço adicional.

Geração de relatórios de resumo

Para gerar resumos, use o Serviço de agregação (operado pela adtech) para processar os relatórios agregáveis. A Aggregation Service adiciona ruído para proteger a privacidade do usuário e retorna o relatório resumido final.

Os relatórios agregáveis são coletados, agrupados em lotes e enviados para o ambiente de adtech.
Este diagrama representa o fluxo assíncrono de dados do endpoint de coleta, agrupando relatórios, passando pelo processamento no serviço de agregação da adtech.

Depois de agrupar os relatórios agregáveis coletados, o lote é processado pelo serviço de agregação. Um coordenador fornece as chaves de descriptografia apenas para versões atestadas do serviço de agregação. Em seguida, o Aggregation Service descriptografa e agrega os dados, adiciona ruído e retorna os resultados como um relatório resumido.

Relatórios agregáveis em lote

Antes de serem processados, os relatórios agregáveis precisam ser agrupados em lotes. Um lote consiste em relatórios agregáveis agrupados estrategicamente. Sua estratégia provavelmente vai refletir um período específico, como diário ou semanal. Esse processo pode ocorrer no mesmo servidor que atua como seu endpoint de relatórios.

Os lotes precisam ter muitos relatórios para garantir que a proporção sinal-ruído seja alta.

Períodos maiores levam a resultados menos ruidosos.
Compare esperar 1 dia e 1 semana. Em uma hora, você terá um valor de resumo menor com resultados provavelmente mais ruidosos. Em um dia, você terá um valor de resumo maior, o que provavelmente vai reduzir o ruído.

Os períodos de agrupamento podem mudar a qualquer momento para garantir que você capture eventos específicos em que espera um volume maior, como uma promoção anual. O período de agrupamento pode ser alterado sem precisar mudar as origens ou os gatilhos de atribuição.

Serviço de agregação

O serviço de agregação é responsável por processar relatórios agregáveis para gerar um relatório de resumo. Os relatórios agregáveis são criptografados e só podem ser lidos pelo Serviço de agregação, que é executado em um ambiente de execução confiável (TEE).

O serviço de agregação solicita chaves de descriptografia do coordenador para descriptografar e agregar os dados. Depois de descriptografados e agregados, os resultados recebem ruído para preservar a privacidade e são retornados como um relatório resumido.

Os profissionais podem gerar relatórios agregáveis em texto não criptografado para testar o serviço de agregação localmente. Ou teste com relatórios criptografados na AWS com Nitro Enclaves.

A seguir

Queremos conversar com você para garantir que vamos criar uma API que funcione para todos.

Discutir a API

Assim como outras APIs do Sandbox de privacidade, ela é documentada e discutida publicamente.

Teste a API

Você pode testar e participar de conversas sobre a API Attribution Reporting.