Visão geral da API Attribution Reporting para a Web

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

Quem é o público-alvo?

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

• Se você trabalha com publicidade ou adtech, vai saber como essa API oferece recursos ativados por cookies de terceiros. Confira os casos de uso da API, que têm mais detalhes sobre como os relatórios são gerados.
• Se você for um desenvolvedor ou engenheiro de software, acesse a visão geral completa do sistema ou teste e participe com a API.

Anunciantes e editores que dependem de plataformas de tecnologia de publicidade para medir conversões não precisam usar a API diretamente. Talvez você queira entender como a API Attribution Reporting funciona se sua adtech planeja fazer a integração com ela.

O que é a API Attribution Reporting?

Hoje, 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 sites e prejudicar a privacidade.

A API Attribution Reporting permite essas medições de uma 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 publisher que usa um provedor de tecnologia de publicidade de terceiros.
• Anúncios em um contexto próprio, como anúncios em uma rede social ou em uma página de resultados de um mecanismo de pesquisa, ou um publisher veiculando os próprios anúncios.

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 quiser testar a API, acesse Relatórios de atribuição: teste e participe.

Mudanças na API

• Acompanhe as mudanças na API.
• Saiba por que lançamos a API Attribution Reporting no primeiro semestre de 2023.

Disponibilidade

Casos de uso e recursos

A API Attribution Reporting dá 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 terceirizado. Esses dois tipos de relatórios podem ser usados simultaneamente e são complementares.

• 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. Os dados do lado da conversão são muito limitados e têm ruído. Isso significa que, 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 junção da identidade do usuário em vários sites. Como uma 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 no lado do anúncio. Esses relatórios fornecem dados de conversão mais completos 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 junção de identidades em vários sites.

Relatórios de eventos

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

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

• Otimização. Responda a perguntas como "Como posso melhorar meu retorno do investimento?". Em especial, esses relatórios podem ser usados para otimizar o posicionamento de anúncios, já que os IDs exclusivos do lado do anúncio podem ser disponibilizados neles. Os relatórios no nível do evento podem fornecer dados de treinamento para modelos de aprendizado de máquina.
• Relatórios de estimativa, em que poucas informações sobre a conversão são necessárias. O limite atual é de três bits de dados de conversão para cliques, o que significa que uma conversão pode ser atribuída a uma entre oito categorias, e um bit para visualizações. A codificação de dados granulares do lado da conversão, como um preço específico ou o momento da conversão, não é compatível com 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 padrões que podem ser usados para identificar atividades de spam ou inválidas.

Relatórios de resumo

Os relatórios de resumo (antes chamados de relatórios agregados) oferecem dados de conversão mais detalhados e mais flexibilidade para combinar dados de cliques ou visualizações e dados de conversão.

Saiba mais sobre os relatórios de resumo.

Os relatórios de resumo são mais adequados para casos de uso de relatórios. 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 no nível do evento (porque os dados de conversão são muito gerais), é uma área de pesquisa ativa.

Outros recursos

Outros recursos dessa API incluem:

• Atribuição de app para a Web: ver ou clicar em um anúncio em um app e fazer uma conversão na Web.

Suporte ao navegador

• O Firefox e o Edge não compartilharam indicadores.
• O Safari e o Webkit são negativos e propuseram uma API diferente para medir conversões de anúncios, chamada Medição de cliques particulares.

Embora as duas APIs sejam diferentes, o Chrome e o WebKit estão trabalhando juntos em código aberto 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 da API Private Click Measurement proposta pelo Safari e pelo WebKit. Principalmente com a API Attribution Reporting:

• A medição de visualização é compatível.
• Relatórios no nível do evento podem ser fornecidos.
• Os relatórios de resumo contêm informações detalhadas sobre cliques/visualizações e conversões.
• Terceiros, como plataformas de tecnologia de publicidade, podem receber relatórios em nome de publishers e anunciantes.

Configuração do navegador

• Os usuários podem desativar a API nas configurações do usuário em chrome://settings/adPrivacy.
• A API não está ativa no modo de 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 de acesso de nível superior, não podem usar a API sem o conhecimento de um publisher ou 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órios de resumo

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

• Um usuário clica ou vê um anúncio especialmente configurado. O navegador no dispositivo local do usuário registra esse evento junto com dados pré-especificados de configuração de atribuição.
• Depois, 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, os relatórios agregáveis 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.

Leia 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 conversões sem rastrear a atividade de um indivíduo em sites.

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

Hoje, 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 em news.example e shoes.example. A adtech pode combinar 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 no shoes.example. Essa junção entre sites é útil para medir 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.

Uma pequena quantidade de informações é unida em todos os sites, o suficiente para medir conversões, mas não para rastrear 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 superficiais para unir a identidade do usuário em vários sites.

Os relatórios de resumo fornecem 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 informações deles sem usar um serviço de agregação. O serviço de agregação só fornece acesso a agregações ruidosas.

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

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

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

• Nenhum identificador entre sites é usado, e nenhuma atividade detalhada de navegação entre sites sai do dispositivo.
• Os relatórios no nível do evento associam 64 bits de informações do lado do anúncio (news.example) a apenas 1 bit ou 3 bits do lado da conversão (shop.example). 64 bits são informações suficientes para serem mapeados para um identificador de usuário individual, mas só podem ser vinculados a pouquíssimas informações entre sites: 1 bit ou 3 bits, que não são suficientes para armazenar um identificador.
  • Os 64 bits do lado do anúncio não são informações novas. Um ID de usuário já pode estar disponível no lado do anúncio. 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 rastreamento entre sites:
  • Os relatórios são enviados com um atraso.
  • Os dados de conversão são ruidosos: em uma determinada 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.

Detalhes: relatórios de resumo e privacidade

Os relatórios de resumo associam um evento de clique ou visualização a dados de conversão detalhados. Eles fornecem insights de conversão sem rastrear 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. Um 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, à medida que o nível de detalhes aumenta, o ruído relativo também aumenta. As segmentações 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 rastreamento entre sites:
  • Os relatórios são enviados com atrasos aleatórios.
  • As consultas em diferentes partes dos dados têm limitação de taxa.

Engajamento e como compartilhar feedback

• Para dúvidas sobre a API, crie um problema no repositório da API.
• Acompanhe as atualizações e os anúncios da API na lista de e-mails da API Attribution Reporting.
• Se você tiver dúvidas técnicas, registre um bug do Chromium.