Meça quando um clique ou uma visualização no 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 da API Attribution Reporting e alguns conceitos subjacentes, mas sem muitos detalhes técnicos.
- Se você trabalha com publicidade ou adtech, vai aprender 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 experimente e participe com a API.
Anunciantes e editores que dependem de plataformas de adtech para medir conversões não precisam usar a API diretamente. Talvez você tenha interesse em entender como a API Attribution Reporting funciona caso sua adtech pretenda fazer a integração com essa API.
O que é a API Attribution Reporting?
Atualmente, a medição de conversões de anúncios usa 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 do usuário.
A API Attribution Reporting permite essas medições de maneira que preserva a privacidade, sem cookies de terceiros.
Essa API permite que anunciantes e provedores de adtech meçam as conversões nos seguintes casos:
- Cliques e visualizações do anúncio.
- Anúncios em um iframe de terceiros, como aqueles em um site de editor que usa um provedor de adtech terceirizado.
- Anúncios em um contexto próprio, como anúncios em uma rede social ou em uma página de resultados de mecanismo de pesquisa, ou um editor que veicula os próprios anúncios.
Se você não conhecer alguns desses termos ou conceitos, consulte o glossário do Sandbox de privacidade.
Testar a API
- Teste localmente em seu navegador. Defina uma sinalização, que instrui o navegador Chrome a ativar recursos experimentais específicos.
Se você tiver interesse em testar a API, acesse Attribution Reporting: experimente e participe.
Mudanças na API
- Acompanhe as mudanças na API.
- Saiba por que enviamos a API Attribution Reporting no primeiro semestre de 2023.
Disponibilidade
Proposta | Status |
---|---|
Jornada de conversão: do app para a Web Explicação sobre a Web e explicação para o Android Aviso sobre a lista de e-mails |
Disponível no Chrome e no Android para teste de origem |
Jornada de conversão: entre dispositivos Explicação |
Esta proposta foi arquivada. No momento, não há planos de implementação. |
Como evitar relatórios agregáveis inválidos usando a verificação de relatórios Explainer |
Previsão para o Chrome no 1o semestre de 2024 |
A lista de permissões padrão para a API Attribution Reporting de permissões vai continuar igual * Aviso de lista de e-mails |
Disponível no Chrome no 1o trimestre de 2023 |
Épsilon configurável de relatório de evento Problema do GitHub |
Disponível no Chrome no 4o trimestre de 2023 |
Padding para payload de relatórios agregáveis Explicação atualizada |
Disponível no Chrome no 4o trimestre de 2023 |
Fase 1: versão flexível do evento Explicação sobre as configurações flexíveis no nível do evento |
Disponível no Chrome no 4o trimestre de 2023
A capacidade de personalizar o número de Relatórios de atribuição e o número/duração das janelas de relatórios. Disponível no Chrome no 1o trimestre de 2024 A capacidade de personalizar o número de bits de dados de acionadores. |
Suporte para depuração da API Attribution Reporting após a descontinuação dos cookies de terceiros Buscar feedback no GitHub |
Previsão para o Chrome no 1o semestre de 2024 |
Suporte à API Attribution Reporting e ao serviço de agregação do Google Cloud Explicação da API Attribution Reporting Explicação do serviço de agregação |
Disponível no Chrome no 2o semestre de 2023 |
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 terceirizado. Esses dois tipos de relatórios podem ser usados simultaneamente e se complementam.
- Os relatórios de eventos associam determinado clique ou visualização (no lado do anúncio) a dados no lado da conversão. Os dados no lado da conversão são muito limitados e recebem ruído, o que significa que, para uma pequena porcentagem de casos, são enviados dados aleatórios em vez de relatórios reais. Isso preserva a privacidade do usuário impedindo a combinação da identidade do usuário em vários sites. Como proteção extra de privacidade, os relatórios são enviados com 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 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 uma visualização no anúncio a dados de conversão gerais.
![Relatório de eventos](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=6&hl=pt)
news.example
(anexado ao ID do usuário Bob_Doe em news.example
) resultou em 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 especificamente para otimizar o posicionamento do anúncio, já que IDs exclusivos do lado do anúncio podem ser disponibilizados nos relatórios. Os relatórios de eventos podem fornecer dados de treinamento para modelos de machine learning.
- Relatórios aproximados, em que poucas informações são necessárias sobre a conversão. O limite atual é de 3 bits de dados de conversão para cliques. Isso significa que uma conversão pode receber uma das oito categorias⏤ e 1 bit para visualizações. A codificação de dados granulares da conversão, como um preço específico ou data/hora da conversão, não é compatível com relatórios de eventos.
- Detecção de fraudes. Os dados em alguns relatórios podem ser úteis para detectar e analisar fraudes de anúncios, permitindo que você entenda os padrões que podem ser usados para identificar atividades com spam ou inválidas.
Relatórios de resumo
Os relatórios de resumo (antes conhecidos como relatórios agregados) oferecem dados de conversão mais detalhados e mais flexibilidade para combinar dados de clique ou visualização e de conversão.
Saiba mais sobre os relatórios de resumo.
![Exemplo de insights de relatórios de resumo.](https://developers.google.cn/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=6&hl=pt)
news.example
levou a 518 conversões em shoes.example
e um gasto total de US $38.174. Metade das conversões foi de usuários em Nova York, EUA.Os relatórios de resumo são mais adequados para casos de uso de relatórios. Esses relatórios ajudam a responder 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, o que não é compatível com relatórios de eventos (porque os dados de conversão são muito escassos) é uma área de pesquisa ativa.
Outros recursos
Outros recursos dessa API incluem:
- Atribuição de app para a Web: veja ou clique em um anúncio em um app e faça uma conversão na Web.
Suporte ao navegador
- O Firefox e o Edge não compartilharam sinais.
- O Safari e o Webkit são negativos, e propuseram uma API diferente para medir as conversões de anúncios, chamada Private Click Measurement.
Embora as duas APIs sejam diferentes, o Chrome e o WebKit estão trabalhando juntos e para simplificar a experiência do desenvolvedor, por exemplo, alinhando-se aos nomes dos atributos e na estrutura JSON para relatórios.
O conjunto de recursos da API Attribution Reporting é diferente do conjunto da API Private Click Measurement proposta pelo Safari e pelo WebKit. Mais especificamente, com a API Attribution Reporting:
- A medição de visualizações é compatível.
- Relatórios de eventos podem ser fornecidos.
- Os relatórios de resumo contêm informações valiosas tanto no lado da conversão quanto no lado do clique/visualização.
- 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 nas configurações do usuário em
chrome://settings/adPrivacy
. - A API não está ativa no modo de navegação anônima.
- A API não fica ativa quando os cookies de terceiros estão desativados.
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, como iframes de anúncios de origem cruzada que não foram adicionados à página com um script com 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 explicitamente ativada 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, você pode medir dois eventos vinculados: um evento no site de um editor, como quando um usuário visualiza ou clica em um anúncio, e depois faz uma conversão no site do anunciante.
Relatórios de eventos
![relatório de eventos](https://developers.google.cn/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=6&hl=pt)
O navegador faz a correspondência entre cliques ou visualizações e dados de conversão definidos por uma adtech.
Mais tarde, o navegador envia os relatórios resultantes para um endpoint predefinido, com algum atraso e ruído.
Relatórios de resumo
![](https://developers.google.cn/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=6&hl=pt)
Os relatórios de resumo são gerados da seguinte forma:
- Um usuário clica ou visualiza um anúncio especialmente configurado. O navegador no dispositivo local do usuário registra esse evento, com os dados de configuração de atribuição pré-especificados.
- Depois, quando o usuário faz a conversão, o navegador faz a correspondência desse evento detalhado de clique ou visualização (conhecido como evento da fonte de atribuição) com dados de conversão detalhados (conhecidos como dados do acionador de atribuição). As dimensões de detalhes capturadas são predefinidas por uma empresa de adtech, e o navegador segue uma lógica específica definida pela adtech. O navegador gera esses dados em um relatório agregável.
- Os relatórios agregáveis são criptografados pelo navegador e enviados a um servidor de adtechs. No servidor de adtechs, os relatórios agregáveis são enviados ao serviço de agregação para gerar um relatório de resumo.
- Os relatórios de resumo são disponibilizados para a adtech. Os relatórios de resumo não têm o mesmo atraso dos 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 recebam insights sobre conversões sem rastrear a atividade de um indivíduo nos sites.
Vamos considerar uma pessoa chamada Bob. Beto encontra um anúncio ao ler
as notícias no news.example
. Uma semana depois, Bob 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 Beto em news.example
e
shoes.example
. A adtech pode mesclar essas
informações para criar um perfil detalhado de Bob,
incluindo a localização, os hábitos de navegação e as
leituras preferenciais 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 combinaçã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 sites com um alto nível de detalhes.
![Visualização lado a lado da Web atual (identidade mesclada) e da Web do futuro (identidade particionada)](https://developers.google.cn/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=6&hl=pt)
Uma pequena quantidade de informações é mesclada
entre os sites: o suficiente para medir as conversões, mas não
o suficiente para rastrear a atividade de Beto nos sites em detalhes. A atividade de Bob em news.example
e em 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 de conversão. Embora elas forneçam informações entre sites sobre uma conversão, as informações no lado da conversão são muito grosseiras para unir a identidade do usuário em 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 são enviados à adtech, ela não pode receber informações dos relatórios sem usar um serviço de agregação. O serviço de agregação só fornece acesso a agregados com ruído.
Outras proteções de privacidade, como limitações de taxa, são impostas nos relatórios agregados e no nível do evento.
![](https://developers.google.cn/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=6&hl=pt)
Em detalhes: privacidade e relatórios no nível do evento
Os relatórios de eventos fornecem insights de conversão sem rastrear os usuários em vários sites seguindo os seguintes mecanismos de privacidade:
- Nenhum identificador entre sites é usado e nenhuma atividade detalhada de navegação entre sites sai do dispositivo.
- Os relatórios de eventos associam 64 bits de informações no lado do anúncio
(
news.example
) a apenas 1 ou 3 bits no lado da 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 com poucas informações entre sites: 1 ou 3 bits, que não são suficientes para conter um identificador.- Os 64 bits do lado do anúncio não são informações novas. Um User-ID já pode estar
disponível no lado do anúncio hoje.
news.example
ouadtech.example
já sabem sobre a atividade de um determinado usuário nonews.example
.
- Os 64 bits do lado do anúncio não são informações novas. Um User-ID já pode estar
disponível no lado do anúncio hoje.
- 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 recebem ruído: em uma determinada porcentagem do tempo, relatórios falsos são gerados.
- O número de relatórios de conversão atribuídos é limitado por clique ou visualização.
Em 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 sobre conversões sem rastrear usuários em sites diferentes 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 determinado clique (ou visualização) e conversão.
- Os dados são agregados até muitos eventos (muitos usuários), e nenhum evento individual pode ser observado com precisão. Ao analisar os dados agregados, conforme o nível de detalhe aumenta, o ruído relativo desses dados também aumenta. Fraçõ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 de clique ou visualização detalhado 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.
Interaja e compartilhe feedback
- Para perguntas sobre a API, crie um problema no repositório da API.
- Siga as atualizações e os avisos da API na lista de e-mails da API Attribution Reporting.
- Se você tiver dúvidas técnicas, registre um bug do Chromium.
- Para perguntas gerais de implementação, integração e práticas recomendadas: crie um problema no repositório de suporte ao desenvolvedor do Sandbox de privacidade.