Visão geral da API Attribution Reporting para a Web

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.

Observação:no futuro, a API Attribution Reporting poderá atender a casos de uso que não são relacionadas à publicidade.

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.

Observação:essa API ainda está em desenvolvimento e vai evoluir ao longo do tempo, dependendo do feedback e das entradas do ecossistema. Sua contribuição ajuda a garantir que as soluções para vários casos de uso sejam discutidas. Essa API está sendo incubada e desenvolvida publicamente. Considere participar da discussão.

Mudanças na API

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

.

Observação:a API Attribution Reporting era conhecida como API Event Conversion Measurement. O nome mudou em 2022, porque o escopo original no nível do evento foi ampliado para abranger outros casos de uso de medição.

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

Observação:para ter uma visão geral do status de todas as APIs do Sandbox de privacidade, consulte Cronograma do Sandbox de privacidade.

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.

Exemplo de relatório de evento: o ID de clique 200400600 em 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.

Confira um exemplo de insights dos relatórios de resumo: o ID da campanha 1234567 em 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.

.

Observação:em um futuro sem cookies de terceiros, essa API seria combinada com outras APIs de anúncios que preservam a privacidade para abranger casos de uso completos: - Remarketing: consulte API Protected Audience - Seleção de anúncios com base em interesses: consulte Tópicos

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.

.

Observação:a API não depende de cookies de terceiros. No entanto, na fase de teste, os cookies de terceiros precisam ser ativados para o a ser ativada. Isso permite que os desenvolvedores recebam relatórios de depuração e comparem Resultados da API com atribuição baseada em cookies.

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.

Observação:

Benefícios de segurança

Ao fazer isso, um script com acesso de nível superior permite que os frames que ele mesmo adicione para usar a API Attribution Reporting. Somente um script de terceiros confiável site deve receber acesso de nível superior, então isso não é um problema. A principal vantagem de segurança da política está em outro lugar: frames que eram adicionados sem um script de nível superior não devem ser confiáveis por padrão para o registro origens ou gatilhos (a menos que o incorporador já seja confiável). É por isso que o site de nível superior é necessário para ativar explicitamente a API para esses iframes.

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.

Observação:talvez a API Attribution Reporting não seja adequada para o faturamento de custo por conversão. necessidades, devido ao ruído adicionado ao nível de evento e relatórios de resumo. Você pode compartilhar feedback sobre o impacto em vários modelos de faturamento a API Attribution Reporting GitHub.

Relatórios de eventos

Os relatórios de evento são gerados da seguinte maneira:
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

Geração do relatório resumido

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)

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.

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ã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 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 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 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.