Visão geral da API Attribution Reporting para a Web

Meça quando um clique ou visualização de anúncio leva a uma conversão, como uma compra no site de um anunciante.

A quem se destina?

Aqui você vai encontrar os conceitos básicos dos Relatórios de atribuição e alguns conceitos subjacentes, mas não muitos detalhes técnicos.

Os anunciantes e editores que dependem de plataformas de adtechs para a medição de conversão não precisam usar a API diretamente. Talvez você queira entender como a Attribution Reporting funciona se a sua adtech planeja se integrar a essa API.

O que é a API Attribution Reporting?

Atualmente, a medição de conversões de anúncios geralmente depende de cookies de terceiros. Os navegadores estão restringindo o acesso a cookies de terceiros porque eles podem ser usados para rastrear usuários em vários sites e prejudicar a privacidade deles.

A API Attribution Reporting permite essas medições de forma que preserva a privacidade, sem cookies de terceiros.

Essa API permite que anunciantes e provedores de adtechs meçam conversões nos seguintes casos:

  • Cliques e visualizações de anúncios.
  • Anúncios em um iframe de terceiros, como anúncios em um site de editor que usa um provedor de adtech de terceiros.
  • Anúncios em um contexto próprio, como em uma rede social ou em uma página de resultados de um mecanismo de pesquisa, ou em um editor que veicula anúncios próprios.

Se você não conhece alguns desses termos ou conceitos, consulte o glossário do Sandbox de privacidade.

Teste a API

  • Teste localmente no navegador. Defina uma flag, que informa ao navegador Chrome para ativar recursos experimentais específicos.

Se você quiser testar a API, acesse Attribution Reporting: experiment and participate.

Mudanças na API

Disponibilidade

提案 状态
转化历程：应用到网站
网站说明和 Android 说明
邮寄名单通告		 适用于 Chrome 和 Android 的源试用
转化历程：跨设备
说明		 此提案已归档。目前没有实施计划。
使用报告验证功能防止可汇总报告无效
说明		 此提案已归档。我们改为为此用例实现了 trigger_context_id。
Attribution Reporting API Permissions-Policy 的默认许可名单将保持不变 *
邮寄名单通告		 2023 年第 1 季度在 Chrome 中推出
可配置的事件级报告 epsilon
GitHub 问题		 2023 年第 4 季度在 Chrome 中推出
可汇总报告载荷的填充
更新了说明		 2023 年第 4 季度在 Chrome 中推出
灵活事件级
“灵活事件级配置”说明		 将于 2023 年第 4 季度在 Chrome 中推出
可自定义归因报告的数量以及报告期的数量/时长。

将于 2024 年第 1 季度在 Chrome 中推出
能够自定义触发器数据的位数。
支持不依赖于第三方 Cookie 的 Attribution Reporting 详细调试报告
说明		 2024 年第 3 季度在 Chrome 中推出
支持 Google Cloud 的 Attribution Reporting API 和汇总服务
Attribution Reporting API 说明
汇总服务说明		 2023 年下半年在 Chrome 中推出
灵活的贡献过滤
说明		 2024 年第 3 季度在 Chrome 中推出
归因前过滤：归因范围
说明		 2024 年第 4 季度在 Chrome 中推出

Casos de uso e recursos

A API Attribution Reporting oferece acesso a diferentes tipos de insights com dois tipos de relatórios que podem ser enviados a um anunciante ou a um provedor de adtech de terceiros. Esses dois tipos de relatório podem ser usados simultaneamente e são complementares.

  • Os relatórios de eventos associam um clique ou uma visualização específicos do anúncio (no lado do anúncio) a dados da conversão. Os dados do lado da conversão são muito limitados e têm ruídos, ou seja, em uma pequena porcentagem de casos, dados aleatórios são enviados em vez de relatórios reais. Isso preserva a privacidade do usuário, impedindo a combinação da identidade do usuário em sites. Como proteção extra de privacidade, os relatórios são enviados com um atraso.
  • Os relatórios de resumo não estão vinculados a um evento específico do lado do anúncio. Esses relatórios fornecem dados de conversão mais ricos e de maior fidelidade do que os relatórios de evento. Uma combinação de técnicas de privacidade ajuda a reduzir o risco de associação de identidade entre sites.

Relatórios de eventos

Os relatórios de eventos associam um clique ou visualização de anúncio a dados de conversão aproximados.

Relatório no nível do evento
Exemplo de relatório no nível do evento: o ID de clique 200400600 em news.example (anexado ao ID do usuário Bob_Doe em news.example) levou a uma compra em shop.example.

Os relatórios de eventos são adequados para:

  • Otimização. Responda a perguntas como "Como posso melhorar meu retorno do investimento?". Esses relatórios podem ser usados para otimizar a veiculação de anúncios, já que os IDs exclusivos do lado do anúncio podem ser disponibilizados nos relatórios. Os relatórios de evento podem fornecer dados de treinamento para modelos de aprendizado de máquina.
  • Relatórios gerais, em que são necessárias poucas informações sobre a conversão. O limite atual é de três bits de dados de conversão para cliques. Isso significa que uma conversão pode ser atribuída a uma das oito categorias e um bit para visualizações. A codificação de dados granulares do lado da conversão, como um preço ou horário de conversão específico, não é compatível com os relatórios de evento.
  • Detecção de fraude. Os dados em alguns relatórios podem ser úteis para a detecção e análise de fraudes de anúncios, permitindo que você entenda os padrões que podem ser usados para identificar atividades inválidas ou de spam.

Relatórios de resumo

Os relatórios de resumo (anteriormente conhecidos como relatórios agregados) oferecem dados de conversão mais detalhados e mais flexibilidade para mesclar dados de cliques ou visualizações e dados de conversão.

Saiba mais sobre os relatórios de resumo.

Exemplo de insights de relatórios de resumo.
Confira um exemplo de insights dos relatórios de resumo: o CampaignID 1234567 em news.example gerou 518 conversões em shoes.example e um gasto total de US $38.174. Metade das conversões foram de usuários em Nova York, nos EUA.

Os relatórios de resumo são mais adequados para casos de uso. Esses relatórios ajudam a responder a perguntas como "Qual é meu retorno do investimento?"

O uso de relatórios de resumo para otimização, por exemplo, para otimizar um valor de compra, que não é compatível com relatórios de evento (porque os dados de conversão são muito genéricos), é uma área de pesquisa ativa.

Outros recursos

Outros recursos da API incluem:

Suporte ao navegador

Embora as duas APIs sejam diferentes, o Chrome e o WebKit estão trabalhando juntos para simplificar a experiência do desenvolvedor, por exemplo, alinhando os nomes dos atributos e a estrutura JSON para relatórios.

O conjunto de recursos da API Attribution Reporting é diferente do da API Private Click Measurement proposta pelo Safari e pelo WebKit. Mais especificamente, com a API Attribution Reporting:

  • A medição de visualização é compatível.
  • É possível fornecer relatórios no nível do evento.
  • Os relatórios de resumo contêm informações detalhadas sobre cliques/visualizações e conversões.
  • Terceiros, como plataformas de adtech, podem receber relatórios em nome de editores e anunciantes.

Configuração do navegador

  • Os usuários podem desativar a API com as configurações do usuário em chrome://settings/adPrivacy.
  • A API não está ativa no modo Navegação anônima.

Como os sites podem controlar o acesso?

Se a API estiver disponível em um determinado navegador, ela estará disponível por padrão em qualquer site, tanto em documentos e scripts de nível superior quanto em iframes de mesma origem.

Terceiros arbitrários, por exemplo, iframes de anúncios entre origens que não foram adicionados à página com um script que tem acesso de nível superior, não podem usar a API sem o conhecimento do editor ou do anunciante: nesses iframes, a API Attribution Reporting precisa ser ativada explicitamente com a política de permissões.

<iframe src="..." allow="attribution-reporting"></iframe>

Terceiros com acesso de nível superior que adicionam iframes de origem cruzada a uma página também podem ativar a API Attribution Reporting com a política de permissões.

Um site pode desativar a API Attribution Reporting para todas as partes, incluindo scripts com acesso de nível superior, enviando o cabeçalho de resposta HTTP:

Permissions-Policy: attribution-reporting=()

Como a API Attribution Reporting funciona?

Com a API Attribution Reporting, é possível medir dois eventos conectados: um evento no site de um publisher, como um usuário visualizando ou clicando em um anúncio, e uma conversão subsequente no site de um anunciante.

Relatórios de eventos

relatório no nível do evento
Os relatórios de eventos são gerados da seguinte forma:
o navegador faz a correspondência entre cliques ou visualizações e dados de conversão definidos por uma adtech.
Depois, o navegador envia os relatórios resultantes a um endpoint pré-definido, com algum atraso e ruído.

Relatórios de resumo

Geração de relatórios de resumo

Os relatórios de resumo são gerados da seguinte forma:

  • Um usuário clica ou vê um anúncio configurado especialmente. O navegador no dispositivo local do usuário registra esse evento junto com dados pré-especificados de configuração de atribuição.
  • Mais tarde, quando o usuário faz a conversão, o navegador conecta esse evento detalhado de clique ou visualização (conhecido como evento de origem da atribuição) com dados de conversão detalhados (conhecidos como dados do acionador da atribuição). As dimensões dos detalhes capturados são pré-definidas por uma empresa de adtech, e o navegador segue uma lógica específica definida por essa empresa. O navegador coloca esses dados em um relatório agregável.
  • Os relatórios agregáveis são criptografados pelo navegador e enviados para um servidor de adtech. Do servidor de adtech, eles são enviados para o serviço de agregação para produzir um relatório de resumo.
  • Os relatórios de resumo ficam disponíveis para a adtech. Eles não sofrem do mesmo atraso que os relatórios de eventos.

Saiba mais sobre os relatórios de resumo.

Privacidade

Ao contrário dos cookies de terceiros, a API Attribution Reporting permite que as empresas de publicidade tenham insights sobre as conversões sem rastrear a atividade de um indivíduo em vários sites.

Vamos usar uma pessoa chamada Bob. Bob vê um anúncio enquanto lê as notícias no news.example. Uma semana depois, Beto compra sapatos na shoes.example.

Atualmente, essa conversão seria rastreada por um cookie de terceiros usado como um identificador entre sites. Com cookies de terceiros, uma empresa de adtech pode acessar muitos detalhes sobre a atividade de Bob no news.example e no shoes.example. A adtech pode mesclar essas informações para criar um perfil detalhado de Bob, incluindo o local, os hábitos de navegação e as leituras preferidas dele no news.example. Esse perfil também pode incluir compras, atividades e informações de cartão de crédito em shoes.example. Essa união entre sites é útil para medir as conversões de anúncios. Mas isso prejudica a privacidade do usuário: a atividade de Bob é rastreada em vários sites com um alto nível de detalhes.

Comparação entre a Web de hoje (identidade combinada) e a de amanhã (identidade particionada)
Comparação entre a Web de hoje (identidade combinada) e a de amanhã (identidade particionada)

Uma pequena quantidade de informações é combinada entre os sites, o suficiente para medir conversões, mas não o suficiente para acompanhar a atividade de Bob em detalhes. A atividade de Bob em news.example e shoes.example permanece separada.

Proteções em cada tipo de relatório

Os relatórios de evento vinculam um identificador do lado do anúncio a uma pequena quantidade de dados do lado da conversão. Embora forneçam informações entre sites sobre uma conversão, as informações do lado da conversão são muito grosseiras para unir a identidade do usuário entre sites.

Os relatórios de resumo oferecem insights detalhados, mas apenas em um nível agregado. Como o conteúdo desses relatórios agregáveis é criptografado quando enviado para a adtech, ela não pode receber nenhuma informação dos relatórios sem usar um serviço de agregação. O serviço de agregação só oferece acesso a agregados com ruído.

Outras proteções de privacidade, como limitações de taxa, são impostas nos relatórios de eventos e agregados.

Detalhes: relatórios e privacidade no nível do evento

Os relatórios de eventos fornecem insights de conversão sem rastrear usuários em diferentes sites, seguindo os seguintes mecanismos de privacidade:

  • Nenhum identificador entre sites é usado, e nenhuma atividade de navegação detalhada entre sites sai do dispositivo.
  • Os relatórios no nível do evento associam 64 bits de informações no anúncio (news.example) com apenas 1 ou 3 bits na conversão (shop.example). 64 bits são informações suficientes para serem mapeadas a um identificador de usuário individual, mas esses 64 bits só podem ser vinculados a muito poucas informações entre sites: 1 ou 3 bits, que não são suficientes para armazenar um identificador.
    • Os 64 bits do anúncio não são novas informações. Um ID do usuário já pode estar disponível no anúncio hoje. news.example ou adtech.example já sabe sobre a atividade de um determinado usuário no news.example.
  • Outras proteções são aplicadas para evitar abusos e o rastreamento entre sites:
    • Os relatórios são enviados com atraso.
    • Os dados de conversão são perturbados: uma certa porcentagem do tempo, relatórios falsos são gerados.
    • O número de relatórios de conversão atribuída é limitado por clique ou visualização.

Em detalhes: relatórios resumidos e privacidade

Os relatórios de resumo associam um evento de clique ou visualização a dados de conversão detalhados. Eles fornecem insights sobre conversões sem rastrear os usuários em diferentes sites usando os seguintes mecanismos de privacidade:

  • Nenhum identificador entre sites é usado.
  • Cada atribuição pode fazer várias contribuições para um relatório de resumo resultante. Qualquer usuário pode acionar várias atribuições para um clique (ou visualização) e uma conversão específicos.
  • Os dados são agregados até o nível de muitos eventos (muitos usuários), e nenhum evento individual pode ser observado com precisão. Ao analisar os dados agregados, o nível de detalhes aumenta, assim como o ruído relativo a esses dados. Fatias de dados que agregam muitos eventos e usuários são mais precisas para preservar a utilidade.
  • Os relatórios brutos que associam um evento detalhado de clique ou visualização a dados de conversão detalhados são criptografados e não podem ser lidos pela empresa de adtech. Esses dados só podem ser lidos pelo serviço de agregação.
  • Outras proteções são aplicadas para evitar abusos e o rastreamento entre sites:
    • Os relatórios são enviados com atrasos aleatórios.
    • As consultas em diferentes fatias dos dados são limitadas pela taxa.

Engajamento e compartilhamento de feedback