O serviço de agregação gera relatórios de resumo com dados detalhados de conversão e medições de alcance de relatórios agregáveis brutos. Como adtech, você pode usar a API Attribution Reporting e a API Private Aggregation, os dois principais pontos de entrada de agregação do lado do cliente, para direcionar relatórios ao serviço de agregação e receber um relatório de resumo em resposta.
Nesta página, presumimos que você tenha experiência em adtech. Ela abrange:
- Status da implementação
- Principais termos e conceitos
- Casos de uso de agregação
- Fluxo completo
- Agrupamento de relatórios agregáveis
- Componentes do Cloud
Status da implementação
- O Serviço de agregação agora está com disponibilidade geral.
- O serviço de agregação pode ser usado com a API Attribution Reporting e a API Private Aggregation para a API Protected Audience e a API Shared Storage.
Disponibilidade
| 提案 | 状态 |
|---|---|
| 跨云隐私预算服务
说明 |
可用 |
| 针对 Attribution Reporting API、Private Aggregation API 中的 Amazon Web Services (AWS) 提供汇总服务支持
说明 |
可用 |
| 针对 Attribution Reporting API、Private Aggregation API 的 Google Cloud 汇总服务支持 说明 |
可用 |
| 汇总服务网站注册和多源汇总。网站注册包括将网站映射到云账号（AWS 或 GCP）。如需汇总多个来源，这些来源必须属于同一网站。
GitHub 上的常见问题解答 Site aggregation API 文档 |
可用 |
| 汇总服务的 epsilon 值将保持在 64 以内的范围内，以便对不同的参数进行实验和反馈。
提交 ARA 小数值反馈。 提交 PAA 小数值反馈。 |
可用。在更新 epsilon 范围值之前，我们会提前通知生态系统。 |
| 为汇总服务查询提供了更灵活的贡献过滤功能
解说 |
可用 |
| 灾难发生后（错误、配置错误等）预算恢复流程
说明 |
已推出 机制，用于查看广告技术平台使用预算恢复功能恢复的共享 ID 的百分比，并暂停计划在 2025 年上半年过度恢复的未来恢复 |
| Accenture 是 AWS 协调者之一
开发者博客 |
可用 |
| 作为 Google Cloud 协调者之一的独立方
开发者博客 |
可用 |
| 汇总服务支持 Attribution Reporting API 上的汇总调试报告
说明 |
可用 |
| 跨云加密密钥服务
解说 |
预计 2025 年上半年 |
Principais termos e conceitos
Se você está considerando o serviço de agregação para seu fluxo de trabalho, os termos e conceitos a seguir podem dar insights sobre o que esse novo fluxo de agregação pode oferecer à sua equipe.
Glossário de termos
- Relatórios agregáveis
-
Os relatórios criptografados são enviados de dispositivos de usuários individuais. Esses relatórios contêm dados sobre o comportamento do usuário entre sites e as conversões. As conversões (às vezes chamadas de eventos acionador de atribuição) e as métricas associadas são definidas pelo anunciante ou pela adtech. Cada relatório é criptografado para impedir que várias partes acessem os dados.
- Contabilização de relatórios agregáveis
-
Um ledger distribuído, localizado nos dois coordenadores, que rastreia o orçamento de privacidade alocado e aplica a regra "Sem duplicações". Esse é o mecanismo de preservação da privacidade, localizado e executado em coordenadores, que garante que nenhum relatório passe pelo serviço de agregação além do orçamento de privacidade alocado.
Saiba mais sobre como as estratégias de lote se relacionam com os relatórios agregáveis.
- Orçamento de contabilidade de relatórios agregáveis
-
Referências ao orçamento que garantem que os relatórios individuais não sejam processados mais de uma vez.
- Serviço de agregação
-
Um serviço operado por adtech que processa relatórios agregáveis para criar um relatório de resumo.
Leia mais sobre o histórico do serviço de agregação em nosso texto explicativo e na lista completa de termos.
- Declaração
-
Um mecanismo para autenticar a identidade do software, geralmente com hashes criptográficos ou assinaturas. Para a proposta de serviço de agregação, o atestado corresponde ao código executado no serviço de agregação operado pela adtech com o código de código aberto.
- Vinculação de contribuições
- Coordenador
-
Entities responsible for key management and aggregatable report accounting. A Coordinator maintains a list of hashes of approved aggregation service configurations and configures access to decryption keys.
- Ruído e escalonamento
-
Ruído estatístico adicionado aos relatórios de resumo durante o processo de agregação para preservar a privacidade e garantir que os relatórios finais forneçam informações de medição anônimas.
Leia mais sobre o mecanismo de ruído aditivo, que é extraído da distribuição de Laplace.
- Origem da denúncia
-
接收可汇总报告的实体，也就是您或调用了 Attribution Reporting API 的广告技术平台。可汇总的报告会从用户设备发送到与报告来源关联的知名网址。报告来源是在注册期间指定的。
- ID compartilhado
-
A computed value that consists of
shared_info,reporting_origin,destination_site(for Attribution Reporting API only),source_registration-time(for Attribution Reporting API only),scheduled_report_time, and version.Multiple reports that share the same attributes in the
shared_infofield should have the same shared ID. Shared IDs play an important role within Aggregatable Report Accounting. - Relatório de resumo
-
Um tipo de relatório da API Attribution Reporting e da API Private Aggregation. Um relatório de resumo inclui dados agregados do usuário e pode conter dados de conversão detalhados com ruído adicionado. Os relatórios de resumo são compostos por relatórios agregados. Eles permitem mais flexibilidade e oferecem um modelo de dados mais rico do que os relatórios no nível do evento, principalmente para alguns casos de uso, como valores de conversão.
- Ambiente de execução confiável (TEE)
-
Uma configuração segura de hardware e software de computador que permite que partes externas verifiquem as versões exatas do software em execução na máquina sem medo de exposição. Os TEEs permitem que terceiros verifiquem se o software faz exatamente o que o fabricante afirma.
Para saber mais sobre os TEEs usados para as propostas do Sandbox de privacidade, leia a explicação dos serviços da API Protected Audience e a explicação do serviço de agregação.
Casos de uso de agregação
Considere as seguintes jornadas de desenvolvedores para a medição de anúncios e as bibliotecas de cliente de medição correspondentes.
| Caso de uso | Ponto de entrada | Descrição |
|---|---|---|
| Otimização de lances | API Attribution Reporting (Chrome e Android) | Use relatórios agregados para importar indicadores de conversão para otimizar os lances. |
| Medição em várias plataformas | API Attribution Reporting (Chrome e Android) | Use os recursos de medição em vários apps e na Web para ter visibilidade da performance no Chrome e no Android. |
| Relatórios de conversão | API Attribution Reporting (Chrome e Android) | Crie relatórios de conversão agregados adaptados às necessidades da campanha dos clientes (incluindo CTCs e VTCs). |
| Medição do alcance da campanha | API Shared Storage e API Private Aggregation (Chrome) | Use variáveis de visualização de anúncios entre sites para medir o alcance da campanha. |
| Relatórios demográficos | API Shared Storage e API Private Aggregation (Chrome) | Use a visualização de anúncios entre sites e as informações demográficas para medir o alcance por demografia. |
| Análise do caminho de conversão | API Shared Storage e API Private Aggregation (Chrome) | Armazene as variáveis de visualização de anúncios entre sites e de conversão para realizar a análise agregada do caminho de conversão. |
| Brand Lift e Conversion Lift | API Shared Storage e API Private Aggregation (Chrome) | Relatórios sobre grupos de teste/controle e informações de pesquisa para medir o aumento da marca e a incrementabilidade. |
| Depuração de leilões | API Protected Audience e API Private Aggregation (Chrome) | Use relatórios agregados para depuração. |
| Distribuição de lances | API Protected Audience e API Private Aggregation (Chrome) | Use relatórios agregados para capturar a distribuição dos valores de lances para leilões. |
Fluxo completo
O diagrama a seguir mostra o serviço de agregação em ação. Vamos nos concentrar no fluxo completo desde o momento em que os relatórios são recebidos de dispositivos móveis e da Web até a criação do relatório de resumo no serviço de agregação.
- Buscar a chave pública para gerar relatórios criptografados.
- Os relatórios agregáveis criptografados são enviados aos servidores de adtechs para coleta, transformação e agrupamento.
- O servidor de adtech agrupa relatórios (no formato avro) e os envia para o serviço de agregação. (Você precisa concluir isso.)
- Um worker de agregação recupera os relatórios agregados para descriptografar.
- O worker de agregação recupera chaves de descriptografia de um coordenador.
- O worker de agregação descriptografa os relatórios para agregação e geração de ruídos.
- O serviço de contabilidade de relatórios agregáveis verifica se há orçamento de privacidade suficiente para gerar um relatório de resumo para os relatórios agregáveis fornecidos.
- Envie um relatório de resumo final.
O diagrama mostra as relações de alto nível que o serviço de agregação tem com as principais APIs de medição de clientes: a API Attribution Reporting, a API Private Aggregation e os coordenadores.
O fluxo começa com as APIs Measurement, como a API Attribution Reporting ou a API Private Aggregation, que geram relatórios de várias instâncias do navegador. O Chrome recebe a chave pública do serviço de hospedagem de chaves no coordenador para criptografar os relatórios antes de enviá-los à origem de relatórios da adtech. As chaves públicas são alternadas a cada sete dias.
A origem de relatórios da adtech precisa ser configurada para coletar e converter os relatórios recebidos para o formato avro e enviá-los ao serviço de agregação, conforme descrito nas estratégias de lote.
Quando você tiver um lote pronto, envie uma solicitação em lote para o serviço de agregação. O serviço de agregação busca chaves de descriptografia do serviço de hospedagem de chaves, descriptografa os relatórios e os agrega e gera ruídos para criar um relatório de resumo. Isso depende de ter orçamento de privacidade suficiente para criá-los.
Você hospeda o endpoint de origem de relatórios da adtech, onde os relatórios são coletados, e o serviço de agregação é implantado na nuvem da adtech.
Relatórios agregáveis em lote
O fluxo de relatórios não seria concluído sem a ajuda do servidor de origem de relatórios designado. Essa é a origem que você teria enviado no processo de inscrição. A origem de relatórios é responsável por coletar, transformar e agrupar os relatórios agregados recebidos e prepará-los para envio ao serviço de agregação no Google Cloud ou na Amazon Web Services. Saiba como preparar seus relatórios agregáveis.
Agora que você já tem o conceito geral, podemos analisar melhor os componentes implantados no serviço de agregação.
Componentes do Cloud
O serviço de agregação consiste em vários componentes de serviço em nuvem. Você usa os scripts do Terraform fornecidos para provisionar e configurar todos os componentes necessários do serviço de nuvem.
Serviço de front-end
Serviço gerenciado do Cloud:Cloud Function (Google Cloud) / API Gateway (Amazon Web Services)
O serviço de front-end é um gateway sem servidor que é o ponto de entrada principal para chamadas da API Aggregation para criação e recuperação do estado de jobs. Ele é responsável por receber solicitações dos usuários do serviço de agregação, validar parâmetros de entrada e iniciar o processo de programação de jobs de agregação.
O serviço de front-end tem duas APIs disponíveis:
| Endpoint | Descrição |
|---|---|
createJob |
Essa API aciona um job do serviço de agregação. Para acionar o job, são necessárias informações como ID do job, detalhes de armazenamento de entrada, detalhes de armazenamento de saída, origem do relatório e muito mais. |
getJob |
Essa API retorna o status do job com um ID especificado. Ele fornece informações sobre o estado do job, como "Recebido", "Em andamento" ou "Concluído". Se o job for concluído, ele também vai retornar o resultado, incluindo as mensagens de erro encontradas durante a execução. |
Confira a documentação da API Aggregation Service.
Fila de jobs
Serviço de nuvem gerenciado:Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services)
A fila de jobs é uma fila de mensagens que contém solicitações de jobs para o serviço de agregação. O serviço de front-end insere solicitações de trabalho na fila, que são consumidas por workers de agregação que as processam.
Cloud Storage
Serviço de nuvem gerenciado:Google Cloud Storage (Google Cloud) / Amazon S3 (Amazon Web Services)
Os arquivos de entrada e saída usados pelo serviço de agregação, como arquivos de relatório criptografados e relatórios de resumo de saída, são mantidos no armazenamento em nuvem.
Banco de dados de metadados do job
Serviço de nuvem gerenciado:Spanner (Google Cloud) / DynamoDB (Amazon Web Services)
O banco de dados de metadados de jobs é usado para armazenar e acompanhar o status dos jobs de agregação. Ele registra metadados, como hora da criação, hora da solicitação, hora da atualização e estado, como "Recebido", "Em andamento" ou "Concluído". Os workers de agregação atualizam o banco de dados de metadados de jobs conforme os jobs avançam.
Worker de agregação
Serviço de nuvem gerenciado:Compute Engine com espaço confidencial (Google Cloud) / Amazon Web Services EC2 com Nitro Enclave (Amazon Web Services).
Um worker de agregação processa as solicitações de job na fila de jobs e descriptografa as entradas criptografadas usando chaves extraídas do serviço de geração e distribuição de chaves (KGDS, na sigla em inglês) nos coordenadores. Para minimizar a latência de processamento de jobs, os workers de agregação armazenam em cache as chaves de descriptografia por um período de 8 horas e as usam nos jobs que processam.
Os workers de agregação operam em uma instância do ambiente de execução confiável (TEE). Um worker processa apenas um job por vez. É possível configurar vários workers para processar jobs em paralelo definindo a configuração de escalonamento automático. Se usado, o escalonamento automático ajusta dinamicamente o número de workers de acordo com o número de mensagens na fila de jobs. É possível configurar o número mínimo e máximo de workers para o escalonamento automático no arquivo de ambiente do Terraform. Para mais informações sobre o escalonamento automático, consulte estes scripts do Terraform: Amazon Web Services ou Google Cloud.
Os workers de agregação chamam o serviço de contabilidade de relatórios agregáveis para a contabilidade de relatórios agregáveis. Esse serviço garante que os jobs só sejam executados se o limite do orçamento de privacidade não tiver sido excedido. Consulte a regra"Sem duplicações". Se o orçamento estiver disponível, um relatório resumido será gerado usando os agregados com ruído. Leia mais detalhes sobre a contabilização de relatórios agregáveis.
Os workers de agregação atualizam os metadados do job no banco de dados de metadados do job. Essas informações incluem códigos de retorno do job e contadores de erros de relatório em caso de falhas parciais. Os usuários podem buscar o estado usando a API de recuperação de estado de jobs getJob.
Consulte este texto explicativo para uma descrição mais detalhada do serviço de agregação.
Próximas etapas
Agora que você já conhece os destaques do serviço de agregação, é hora de implantar sua própria instância dele no Google Cloud ou na Amazon Web Services. Consulte a seção de início ou acesse este link para saber mais sobre como operar o serviço de agregação.
Solução de problemas
Consulte o documento Códigos de erro e mitigações comuns para ver descrições detalhadas das mensagens de erro, o que pode ter causado um erro que você está enfrentando e as próximas etapas para mitigação.
Receber suporte e enviar feedback
- Para perguntas sobre o produto, feedback e solicitações de recursos, crie um problema no nosso repositório do GitHub.
- Se você estiver com um erro ao implantar, manter ou executar trabalhos com o serviço de agregação, use este formulário de suporte técnico para solicitar suporte técnico.
- Verifique se há problemas conhecidos no Painel de status público.