Meça os dados agregados de usuários com as APIs Attribution Reporting e Private Aggregate.
Status da implementação
- Participe e teste os relatórios de resumo da API Attribution Reporting.
O que é um relatório de resumo?
Um relatório de resumo é compilado para um grupo de usuários de modo que não pode ser vinculado a nenhum indivíduo. Os relatórios de resumo oferecem dados de conversão detalhados com flexibilidade para dados de cliques e visualizações. Os relatórios de resumo não dependem de cookies ou mecanismos de terceiros que podem ser usados para identificar usuários individuais em sites.
Os relatórios de resumo são criados em dois contextos:
- Medição de anúncios: as adtechs podem gerar relatórios de resumo com a API Attribution Reporting para medir quando um clique ou uma visualização no anúncio leva a uma conversão no site de um anunciante, como uma venda ou inscrição. As adtechs também podem gerar relatórios de resumo para leilões da API Protected Audience com agregação privada.
- Relatórios gerais entre sites: os desenvolvedores capturam dados entre sites no armazenamento compartilhado e podem gerar relatórios sobre esses dados com a Agregação privada. Isso tem muitos usos, como conseguir insights sobre as informações demográficas dos usuários e capturar alcances únicos para o conteúdo.
Os relatórios de resumo são solicitados de maneira diferente para a API Attribution Reporting e a Agregação particular. Antes de aprender a gerar relatórios, você precisa entender o que é agregação e como os relatórios resumidos podem ser usados para atender às suas necessidades de medição.
Principais conceitos
Projetar sua coleta de dados
Um princípio fundamental dos relatórios de resumo são as decisões iniciais do projeto. Você decide quais dados coletar em quais categorias. Os relatórios resultantes fornecem insights sobre suas campanhas ou negócios.
O relatório resultante oferece dados detalhados de conversão entre sites, além de flexibilidade para mesclar dados de cliques e visualizações com os de conversão. Também é possível pensar na saída final como uma entrada para as ferramentas que você usa para tomar decisões.
Pergunte: o que eu quero aprender sobre o engajamento dos usuários com meu conteúdo?
Conversões de anúncios
Por exemplo, se você gerar relatórios de resumo para determinar quantas conversões resultaram em um valor de gasto total, isso poderá ajudar sua equipe a decidir qual deve ser a meta da próxima campanha publicitária para gerar um gasto total maior.
![Diagrama que mostra como vários relatórios agregáveis são processados e o ruído é adicionado para gerar relatórios de resumo específicos.](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/diagram-shows-multiple-f504e84e824cc.png?authuser=8&hl=pt-br)
Engajamento entre sites
Por exemplo, se você gerar relatórios de resumo para determinar quantas pessoas leem seu conteúdo em um site de terceiros, isso pode ajudar sua equipe a decidir como fazer uma parceria para gerar mais engajamento e incentivar os leitores a acessar seu site diretamente.
Quais informações são capturadas no navegador?
Os relatórios agregáveis são dados brutos capturados do navegador do usuário, incluindo um conjunto predeterminado de buckets (ou chaves de agregação). A maneira como você determina esses critérios depende das suas decisões de design.
Os relatórios de resumo oferecem uma combinação de dados agregados com dados de conversão detalhados.
Conversões de anúncios
As conversões são definidas pelo anunciante ou pela empresa de adtech e podem ser diferentes para cada campanha publicitária. Uma campanha pode medir o número de cliques no anúncio seguidos por um usuário que compra o item anunciado. Outra campanha poderia medir quantas visualizações de anúncios levaram a visitas ao site do anunciante.
Por exemplo, um provedor de adtech veicula uma campanha publicitária em news.example, em que uma conversão representa um usuário que clica em um anúncio de sapatos e conclui a compra de sapatos.example.
A adtech recebe um relatório de resumo dessa campanha publicitária com o ID 1234567
, que informa que houve 518 conversões em "Shoes.example" em 12 de janeiro de 2022, com um gasto total de US$38.174. 60% das conversões foram de usuários que compraram tênis azuis com o SKU de produto 9872
, e 40% foram de usuários que compraram sandálias amarelas com o SKU do produto 2643
. O ID da campanha são dados detalhados do anúncio, enquanto as SKUs do produto são dados de conversão detalhados. O número de conversões e o gasto total são dados agregados.
Engajamento entre sites
Antes de coletar dados, defina as informações que você quer coletar, identifique as conversões esperadas de qualquer integração entre sites e determine qual tipo de relatório coletar.
Há vários casos de uso possíveis, detalhados na documentação da agregação particular. Vamos analisar um exemplo:
Convém medir as informações demográficas dos usuários que viram seu conteúdo em sites diferentes. A agregação particular pode fornecer uma resposta, como "Aproximadamente 317 usuários únicos têm entre 18 e 45 anos e são da Alemanha". Primeiro, decida especificamente quais informações você quer coletar (como idade e local). Em seguida, use o Armazenamento compartilhado para coletar essas informações demográficas específicas de um site de terceiros. Posteriormente, você poderá enviar um relatório pela agregação particular com as dimensões de idade e país codificadas na chave de agregação.
Como os dados são capturados antes da agregação?
Os relatórios de resumo são compostos por dados agregados de um grupo de dispositivos individuais. Embora as ações de um usuário individual não possam ser observadas e revisadas, o processo de coleta é o mesmo para cada pessoa.
As ações de um usuário individual são criptografadas e coletadas em um relatório agregável. Esses relatórios também incluem uma pequena quantidade de metadados não criptografados relevantes para lotes.
No caso dos dados da API Attribution Reporting, os relatórios agregáveis são capturados da seguinte forma:
- Um usuário visita o site de um editor e vê ou clica em um anúncio, também conhecido como evento de fonte de atribuição.
- Alguns minutos ou dias depois, o usuário faz a conversão, o que é conhecido como evento acionador de atribuição. Por exemplo, uma conversão pode ser definida como uma compra de produto.
- O software do navegador faz a correspondência entre o clique ou a visualização no anúncio e o evento de conversão. Com base nessa correspondência, o navegador cria um relatório agregável com uma lógica específica gerada por um provedor de adtech.
- O navegador criptografa esses dados e, após um pequeno atraso, os envia a um servidor de adtech para coleta. O servidor de adtechs precisa de um serviço de agregação para acessar os insights com ruído.
A agregação particular tem esta aparência:
- Um terceiro decide o que quer medir e grava os dados no armazenamento compartilhado para serem lidos mais tarde.
- O usuário aciona um evento que corresponde ao que o terceiro quer medir. Por exemplo, quando o usuário visita um site com conteúdo incorporado, o terceiro pode ler os dados no armazenamento compartilhado e usar a agregação privada para enviar relatórios agregáveis criptografados ao seu servidor para coleta.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/2Si3rdSh7jr3S6UZTSrg.png?authuser=8&hl=pt-br)
Como gerar relatórios agregáveis em lote
Antes que os relatórios agregáveis coletados possam ser processados e agregados em um relatório de resumo, eles precisam ser agrupados. Um lote é um grupo estratégico de relatórios agregáveis.
Os relatórios agregáveis têm uma pequena quantidade de dados não criptografados, incluída como shared_info
, que pode ser usada para criar lotes. Isso inclui o carimbo de data/hora e a origem do relatório. Não é possível criar lotes com base em informações criptografadas do relatório.
O ideal é que os lotes contenham muitos relatórios. É possível agrupar por hora, dia, semana ou qualquer outro período de sua escolha. Essa estratégia pode mudar em eventos específicos em que um tráfego maior é esperado.
Por exemplo, ao agrupar relatórios agregáveis para a API Attribution Reporting, você pode atualizar a estratégia de lotes para "por hora" no dia de uma grande promoção, em que espera um volume maior de conversões de anúncios.
Com a API Private Aggregate, você pode mudar sua estratégia no dia de um grande comunicado à imprensa sobre um conteúdo específico incorporado a sites de terceiros.
Como processar dados com o serviço de agregação
O serviço de agregação descriptografa e combina os dados em lote dos relatórios agregáveis, adiciona ruído e retorna o relatório de resumo final. Esse serviço é executado em um ambiente de execução confiável (TEE), implantado em um serviço de nuvem compatível com as medidas de segurança necessárias para proteger esses dados.
Relatórios de resumo com a API Attribution Reporting
Para que os provedores de adtech recuperem um relatório de resumo, siga estas etapas:
- O provedor de adtech coleta relatórios agregáveis dos navegadores de usuários individuais.
- O provedor de adtech agrupa os relatórios agregáveis e envia os lotes para o serviço de agregação.
- O serviço de agregação programa um worker para agregar os dados.
- O worker de agregação descriptografa e agrega dados dos relatórios agregáveis, além de dados com ruído.
- O serviço de agregação retorna o relatório de resumo ao provedor de adtech.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/U1ZeswSEnAMSSoCcE5Za.png?authuser=8&hl=pt-br)
A adtech pode usar o relatório de resumo para informar lances e oferecer relatórios aos próprios clientes. Um esquema codificado em JSON é o formato proposto para relatórios de resumo.
Relatórios de resumo com agregação particular
- Ler os dados entre sites coletados pelo armazenamento compartilhado e gerar uma chave de agregação para agrupar os dados.
- Chame a API Private Aggregate de um worklet de armazenamento compartilhado com a chave de agregação e o valor que você quer acumular. O navegador gera um relatório agregável criptografado usando sua entrada e o envia ao servidor para coleta.
- Agrupar os relatórios agregáveis em lote e enviá-los ao serviço de agregação para processamento.
- O serviço de agregação processa os relatórios em lote e adiciona ruído.
- O serviço de agregação retorna o relatório de resumo ao solicitante.
Interaja e compartilhe feedback
Os relatórios de resumo são uma parte fundamental das propostas de medição do Sandbox de privacidade. Assim como outras propostas do Sandbox de privacidade, ela é documentada e discutida publicamente no GitHub.
- Conversar sobre a API Attribution Reporting.
- Converse sobre a API Private Aggregate.
- Suporte ao desenvolvedor: faça perguntas e participe de discussões no repositório de suporte para desenvolvedores do Sandbox de privacidade.