Meça quando um clique ou uma visualização no anúncio leva a uma conversão, como uma compra em um site do anunciante.
A quem se destina?
Aqui você encontra os conceitos básicos da API Attribution Reporting e algumas conceitos básicos, 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. Marca de seleção os casos de uso da API, que mostram mais detalhes os relatórios são gerados.
- Se você for desenvolvedor ou engenheiro de software, acesse a visão geral completa do sistema ou experimentar e participar com a API.
Anunciantes e editores que dependem de plataformas de adtech para conversão. não precisam usar a API diretamente. Talvez você tenha interesse em entender como os Relatórios de atribuição funcionam quando sua adtech planeja fazer a integração com essa API.
O que é a API Attribution Reporting?
Hoje, a medição de conversões de anúncio geralmente depende de serviços de cookies. Os navegadores estão restringindo o acesso a cookies de terceiros porque eles podem ser para rastrear usuários em sites e prejudicar a privacidade do usuário.
A API Attribution Reporting permite essas medições em uma maneira de preservar a privacidade, sem cookies de terceiros.
Com essa API, anunciantes e provedores de adtech medem as conversões nos seguintes casos:
- Cliques e visualizações do anúncio.
- Anúncios em um iframe de terceiros, como anúncios em um site de editor que usa um um provedor de tecnologia de publicidade terceirizado.
- Anúncios em um contexto próprio, como anúncios em uma rede social ou em uma pesquisa página de resultados do mecanismo de pesquisa ou um editor que veicula os próprios anúncios.
Se você não estiver familiarizado com alguns desses termos ou conceitos, consulte o Glossário do Sandbox de privacidade.
Teste a API
- Teste localmente em seu navegador. Defina uma sinalização, que instrui o navegador Chrome a ativar tecnologias experimentais atributos de machine learning.
Se você tiver interesse em testar a API, acesse API 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 dá acesso a diferentes tipos de insights com dois tipos de relatórios que podem ser enviados a um anunciante ou a uma adtech terceirizada de nuvem. Esses dois tipos de relatório podem ser usados simultaneamente e se complementam.
- Os relatórios de eventos associam um anúncio específico clique ou visualização (no lado do anúncio) com dados do lado da conversão. Os dados de conversão são muito limitados e há ruídos (ou seja, para 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 mesclagem de identidade do usuário em locais 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 no lado do anúncio. Esses relatórios fornecem dados de conversão mais avançados e com maior fidelidade do que os relatórios de eventos. Uma combinação de técnicas de privacidade ajuda a reduzir 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-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-4b1ba87d8a313.png?authuser=19&hl=pt-br)
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 em investimento?". Esses relatórios podem ser usados especificamente para otimizar campanhas 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 gerais, em que poucas informações são necessárias sobre a e conversão em massa. O limite atual é de 3 bits de dados de conversão para cliques ⏤ isso significa que uma conversão pode ser atribuída a uma das oito categorias ⏤ e 1 bit para visualizações. Codificação de dados granulares de conversão, como o preço ou a hora da conversão específicos não são compatíveis com relatórios de eventos.
- Detecção de fraudes. Os dados em alguns relatórios podem ser úteis em caso de fraude de anúncios detecção e análise, permitindo que você entenda os padrões que podem ser para identificar atividades inválidas ou spam.
Relatórios de resumo
Os relatórios de resumo (anteriormente conhecidos como relatórios agregados) oferecem dados de conversão e mais flexibilidade para unir dados de clique ou visualização e conversão dados.
Saiba mais sobre os relatórios de resumo.
![Exemplo de insights de relatórios de resumo.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/example-insights-summar-bd9dcd367d4a8.png?authuser=19&hl=pt-br)
news.example
gerou 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 responder a perguntas como: "Qual é meu retorno do investimento?"
Uso de relatórios de resumo para otimização, por exemplo, para otimizar para um o valor de compra, o que não é suportado por relatórios de eventos (porque 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: ver ou clicar em um anúncio em um app e converter na Web.
Suporte ao navegador
- O Firefox e o Edge não compartilharam sinais.
- O Safari e o Webkit são negativos. e propôs uma API diferente para medir as conversões de anúncios, chamada Clique privado medição.
Embora as duas APIs sejam diferentes, o Chrome e o WebKit estão trabalhando juntos na para simplificar a experiência do desenvolvedor, por exemplo, alinhando-se de atributos e na Estrutura JSON para relatórios.
O conjunto de recursos da API Attribution Reporting é diferente do conjunto A 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 da 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 da mesma origem.
Terceiros arbitrários, por exemplo, iframes de anúncios de origem cruzada que não foram foi adicionado à página com um script que tem acesso de nível superior (não é possível usar a API) sem o conhecimento do editor ou do anunciante: nesses iframes, o A API Attribution Reporting precisa ser ativada explicitamente com Permissões política.
<iframe src="..." allow="attribution-reporting"></iframe>
Terceiros com acesso de nível superior que adicionam iframes de origem cruzada a uma página podem ativar a API Attribution Reporting 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 juntos: um evento no site de um editor, como um usuário visualizando ou clicando um anúncio e uma conversão subsequente no site do anunciante.
Relatórios de eventos
![relatório de eventos](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/event-level-report-ef2aec13f54f9.png?authuser=19&hl=pt-br)
O navegador faz a correspondência entre cliques ou visualizações e os 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-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/un70ZcJVrWepdWWsnMIY.png?authuser=19&hl=pt-br)
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 são atrasados na mesma medida que os relatórios de evento.
Leia mais sobre os relatórios de resumo.
Privacidade
Ao contrário dos cookies de terceiros, a API Attribution Reporting permitem que as empresas de publicidade tenham insights conversões sem acompanhar a atividade da pessoa entre sites.
Vamos considerar uma pessoa chamada Bob. Beto vê um anúncio enquanto lê
notícias em news.example
. Uma semana depois, Bob compra sapatos
shoes.example
:
Hoje, essa conversão seria acompanhada por um terceiro
usado como um identificador entre sites.
Com cookies de terceiros, uma empresa de adtech pode acessar vários
de detalhes sobre a atividade de Beto em news.example
e em
shoes.example
. A adtech pode mesclar essas partes
informações para criar um perfil detalhado de Bob,
incluindo a localização de Beto, hábitos de navegação e
leituras preferenciais em news.example
. Este perfil também pode
incluem compras, atividades e informações de cartão de crédito
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 Beto é acompanhada em sites com alto nível de detalhes.
![Visualização lado a lado da Web atual (identidade mesclada) e da Web do futuro (identidade particionada)](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/side-side-view-todays-3550e5be0d783.jpg?authuser=19&hl=pt-br)
Uma pequena quantidade de informações é mesclada
entre sites, o suficiente para medir as conversões, mas não
o suficiente para rastrear a atividade de Beto em sites com detalhes. do Bob
a atividade em news.example
e em shoes.example
permanece
em separado.
Proteções em cada tipo de relatório
Os relatórios de evento vinculam um identificador do lado do anúncio com uma pequena quantidade dados de conversão. Embora elas forneçam informações entre sites sobre um conversão, as informações da conversão são muito escassas para se juntar ao usuário a identidade entre sites.
Os relatórios de resumo fornecem insights detalhados, mas apenas em um nível agregado. porque o conteúdo desses relatórios agregáveis são criptografados quando são enviados à adtech, ela não pode acessar informações dos relatórios sem usar um serviço de agregação. Apenas o serviço de agregação fornece acesso a agregados com ruído.
Proteções adicionais de privacidade, como limitações de taxa, são impostas a ambos relatórios agregados e no nível do evento.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/mDdo2XLyGLBCAlgH7MPZ.png?authuser=19&hl=pt-br)
Em detalhes: privacidade e relatórios no nível do evento
Os relatórios de eventos fornecem insights sobre conversões sem acompanhar os usuários sites, seguindo os seguintes mecanismos de privacidade:
- Nenhum identificador entre sites é usado e não há atividade detalhada de navegação entre sites sair do dispositivo.
- Os relatórios de eventos associam 64 bits de informações no lado do anúncio
(
news.example
) com apenas 1 ou 3 bits no lado da conversãoshop.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 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 ser
disponível no lado do anúncio.
news.example
ouadtech.example
já sabe 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 ser
disponível no lado do anúncio.
- 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ídos: 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 em um resumo resultante. no relatório. Qualquer usuário pode acionar várias atribuições para um determinado clique (ou visualização) e conversão.
- Os dados são agregados ao nível de muitos eventos (muitos usuários) e nenhum eventos individuais possam ser observados com precisão. Ao observar o dados agregados, à medida que o nível de detalhe aumenta, o ruído relativo também aumenta nesses dados também aumenta. Fatias de dados que agregam muitos eventos. e os usuários são mais precisos para preservar a utilidade.
- Os relatórios brutos que associam um evento de clique ou visualização detalhado com os dados de conversão 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: criar um problema no repositório da API.
- Siga as atualizações e os anúncios da API na Lista de e-mails da Attribution Reporting.
- Em caso de dúvidas técnicas, registrar um bug do Chromium.
- Para perguntas sobre implementação, integração e práticas recomendadas gerais: criar um problema no repositório de suporte ao desenvolvedor do Sandbox de privacidade.