Meça os dados agregados entre os usuários com a API Attribution Reporting e a API Private Aggregation.
Status da implementação
- Participe e teste os relatórios de resumo dos Relatórios de atribuição.
O que é um relatório de resumo?
Um relatório de resumo é compilado para um grupo de usuários para que não possa 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 de terceiros ou mecanismos que possam 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 resumidos com a API Attribution Reporting para medir quando um clique ou visualização de 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 particular.
- Relatórios gerais entre sites: os desenvolvedores capturam dados entre sites no Shared Storage e podem gerar relatórios sobre esses dados com a Private Aggregation. Isso tem muitos usos, como insights sobre as informações demográficas dos usuários e captura de alcances únicos para conteúdo.
Os relatórios de resumo são solicitados de maneira diferente para os Relatórios de atribuição e a Agregação privada. Antes de aprender a gerar relatórios, você precisa entender o que é agregação e como os relatórios de resumo podem ser usados para atender às suas necessidades de medição.
Principais conceitos
Projetar a coleta de dados
Um princípio fundamental dos relatórios de resumo é a tomada de decisões de design antecipadas. Você decide quais dados coletar em quais categorias. Os relatórios de saída oferecem insights sobre suas campanhas ou empresa.
O relatório de saída oferece dados detalhados de conversão entre sites e flexibilidade para mesclar dados de cliques e visualizações com dados de conversão. Você também pode pensar na saída final como uma entrada para as ferramentas que usa para tomar decisões.
Pergunte a si mesmo: o que eu quero saber 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 levaram a um valor total de gasto, isso pode ajudar sua equipe a decidir qual será o público-alvo da próxima campanha publicitária para gerar um gasto total maior.

Engajamento entre sites
Por exemplo, se você gerar relatórios de resumo para determinar quantas pessoas leram seu conteúdo no site de terceiros, isso pode ajudar sua equipe a decidir como fazer parceria com esse site para gerar mais engajamento e incentivar os leitores a acessar seu site diretamente.
Quais informações são capturadas no navegador?
Um relatório agregável é o conjunto de dados brutos capturado do navegador de um usuário, que inclui um conjunto predeterminado de buckets (ou chaves de agregação). A forma de determinar 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 adtech e podem ser diferentes para diferentes campanhas publicitárias. Uma campanha pode medir o número de cliques em anúncios que foram seguidos por um usuário que comprou o item anunciado. Outra campanha pode medir quantas visualizações de anúncios geraram 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 em shoes.example.
A adtech recebe um relatório resumido dessa campanha publicitária com o ID 1234567
, que indica 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 a SKU do produto 9872
, e 40% foram usuários que compraram sandálias amarelas com a SKU do produto 2643
. O ID da campanha são dados detalhados do anúncio, enquanto os 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 capturar dados, você precisa definir quais informações quer coletar, identificar as conversões que espera de qualquer integração entre sites e determinar o tipo de relatório a ser coletado.
Há vários casos de uso possíveis, detalhados na documentação da agregação privada. Confira um exemplo:
Você pode medir as informações demográficas dos usuários que acessaram seu conteúdo em diferentes sites. A agregação particular pode fornecer uma resposta, como "Aproximadamente 317 usuários únicos têm entre 18 e 45 anos e estão na Alemanha". Primeiro, decida especificamente quais informações você quer coletar (como idade e local). Em seguida, use o Shared Storage para coletar esses dados demográficos específicos de um site de terceiros. Mais tarde, é possível enviar um relatório pela agregação privada com as dimensões de grupo 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 analisadas, 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 a geração de lotes.
Para dados de relatórios de atribuição, os relatórios agregáveis são capturados da seguinte forma:
- Um usuário visita o site de um editor e visualiza ou clica em um anúncio, também conhecido como evento de origem da atribuição.
- Alguns minutos ou dias depois, o usuário faz a conversão, também conhecido como evento de acionamento da atribuição. Por exemplo, uma conversão pode ser definida como a compra de um produto.
- O software do navegador associa o clique ou a visualização do anúncio ao evento de conversão. Com base nessa correspondência, o navegador cria um relatório agregável com uma lógica específica criada por um provedor de adtech.
- O navegador criptografa esses dados e, após um pequeno atraso, os envia para um servidor de adtech para coleta. O servidor de adtech precisa depender de um serviço de agregação para acessar os insights com ruído.
Para a agregação privada, é assim:
- 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 a empresa terceirizada quer medir. Por exemplo, quando o usuário acessa 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 criptografados e agregáveis ao seu servidor para coleta.

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ídos como shared_info
, que podem ser usados 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 no relatório.
O ideal é que os lotes tenham muitos relatórios. Você pode agrupar os lotes por hora, dia, semana ou qualquer outra cadência. Essa estratégia pode mudar para 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 sua estratégia de agrupamento para a cada hora no dia de uma grande venda, em que você espera um volume maior de conversões de anúncios.
Com a API Private Aggregation, você pode mudar sua estratégia no dia de um grande comunicado à imprensa sobre um conteúdo específico incorporado em sites de terceiros.
Processar dados com o serviço de agregação
O serviço de agregação descriptografa e combina os dados agrupados 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), que é implantado em um serviço de nuvem que oferece suporte às medidas de segurança necessárias para proteger esses dados.
Relatórios de resumo com Relatórios de atribuição
Para que os provedores de adtechs extraiam um relatório resumido, é necessário seguir 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 os envia ao 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, junto com dados com ruído.
- O serviço de agregação retorna o relatório de resumo ao provedor de adtech.

A adtech pode usar o relatório resumido para informar os 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
- Leia os dados entre sites coletados pelo Armazenamento compartilhado e gere uma chave de agregação para agrupar os dados.
- Chame a API Private Aggregation de um worklet do Shared Storage com a chave de agregação e o valor que você quer acumular. O navegador gera um relatório agregável criptografado com base na entrada e o envia para o servidor para coleta.
- Gerar lotes de relatórios agregáveis 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 para o solicitante.
Engajamento e compartilhamento de feedback
Os relatórios de resumo são uma parte importante das propostas de medição do Sandbox de privacidade. Como outras propostas do Sandbox de privacidade, essa proposta é documentada e discutida publicamente no GitHub.
- Discuta a API Attribution Reporting.
- Discuta a API Private Aggregation.
- Suporte para desenvolvedores: faça perguntas e participe de discussões no Repositório de suporte para desenvolvedores do Sandbox de privacidade.