汇总服务

汇总服务会根据原始可汇总报告生成摘要报告,其中包含详细的转化数据和覆盖面衡量结果。广告技术平台在客户端上有两个主要的汇总入口点,可通过 Attribution Reporting API 或 Private Aggregation API 将报告汇总到汇总服务。

实现状态

可用性

提案 状态
全方位跨云协调方(多方密钥托管服务和隐私预算服务) 2025 年下半年
跨云隐私预算服务
说明
可用
针对 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 上的汇总调试报告的支持
说明
可用

关键术语和概念

如果您考虑在广告技术工作流中使用汇总服务,以下术语和概念应该能让您更深入地了解这项新的汇总流程可以为您的团队提供哪些帮助:

Term Description
Aggregation Service An ad tech-operated service that processes aggregatable reports to create a summary report.
Aggregatable Reports

Aggregatable reports are encrypted reports sent from individual user devices. These reports contain data about cross-site user behavior and conversions. Conversions (sometimes called attribution trigger events) and associated metrics are defined by the advertiser or ad tech. Each report is encrypted to prevent various parties from accessing the underlying data.

Learn more about aggregatable reports.
Aggregatable Report Accounting A distributed ledger located in both coordinators that tracks allocated privacy budget and enforces the 'No Duplicates' rule. This is the privacy preserving mechanism, located and run within coordinators, that ensures that no report passes through Aggregation Service beyond the allocated privacy budget. Read more on batching strategies on how it relates to aggregatable reports.
Aggregatable Report Accounting Budget References to the budget that ensures reports are not processed more than once.
Trusted Execution Environment (TEE)

A trusted execution environment is a special configuration of computer hardware and software that allows external parties to verify the exact versions of software running on the computer. TEEs allow external parties to verify that the software does exactly what the software manufacturer claims it does—nothing more or less.

To learn more about TEEs used for the Privacy Sandbox proposals, read the Protected Audience API services explainer and the Aggregation Service explainer.

Coordinators

A coordinator is an entity responsible for key management and aggregatable report accounting. The coordinator maintains a list of hashes of approved aggregation service configurations and configures access to decryption keys.

Shared ID Computed value that consists of: shared_info, reporting_origin, destination_site (available for Attribution Reporting API only), source_registration-time (available for Attribution Reporting API only), scheduled_report_time, version. This means that multiple reports belong to the same shared ID should they share the same attributes of the shared_info field. This plays an important role within Aggregatable Report Accounting. Read more about Trusted Servers.
Summary Report

摘要报告是一种 Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据,并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比,摘要报告具有更大的灵活性和数据模型,尤其是对于某些应用场景(例如转化价值)。

Reporting Origin

The reporting origin is the entity that receives aggregatable reports—in other words, the ad tech that called the Attribution Reporting API. Aggregatable reports are sent from user devices to a well-known URL associated with the reporting origin. This reporting origin should be designated during enrollment.

Contribution Bonding Aggregatable reports may contain an arbitrary number of counter increments. For example, a report may contain a count of products that a user has viewed on an advertiser's site. The sum of increments in all aggregatable reports related to a single source event must not exceed a given limit, `L1=2^16`. Learn more in the aggregatable reports explainer.
Noise & Scaling A certain amount of statistical noise is added to summary reports as a part of the aggregation process that also functions to preserve privacy and ensure the final reports provide anonymized measurement information. Read more about additive noise mechanism, which is drawn from Laplace distribution.
Attestation

Attestation is a mechanism to authenticate software identity, usually with cryptographic hashes or signatures. For the aggregation service proposal, attestation matches the code running in the ad tech-operated aggregation service with the open source code.

Read more about attestation.

如需详细了解汇总服务的背景信息,请参阅我们的说明文档完整术语列表

汇总用例

请考虑以下广告效果衡量开发者历程及其对应的衡量客户端库。

使用场景 入口点 说明
出价优化 Attribution Reporting API (Chrome 和 Android) 使用汇总报告提取转化信号,以便进行出价优化。
跨平台衡量 Attribution Reporting API (Chrome 和 Android) 使用跨网站和应用衡量功能,了解在 Chrome 和 Android 设备上的效果。
转化报告 Attribution Reporting API (Chrome 和 Android) 根据客户的广告系列需求(包括 CTC 和 VTC)创建汇总转化报告。
广告系列覆盖面衡量 Shared Storage APIPrivate Aggregation API(Chrome) 使用跨网站广告观看变量衡量广告系列覆盖面。
受众特征报告 Shared Storage APIPrivate Aggregation API(Chrome) 使用跨网站广告观看和受众特征信息来按受众特征衡量覆盖面。
转化路径分析 Shared Storage APIPrivate Aggregation API(Chrome) 存储跨网站广告观看和转化变量,以执行汇总的转化路径分析。
品牌提升效果和转化量提升情况 Shared Storage APIPrivate Aggregation API(Chrome) 针对测试组/对照组和投票信息生成报告,以衡量品牌提升效果和增量效果。
竞价调试 Protected Audience APIPrivate Aggregation API(Chrome) 使用汇总报告进行调试。
出价分布 Protected Audience APIPrivate Aggregation API(Chrome) 使用汇总报告来了解竞价出价值的分布情况。

端到端流程

下图展示了汇总服务的运作方式。我们将重点介绍从接收来自网站和移动设备的报告到在汇总服务中创建摘要报告的端到端流程。

端到端汇总服务流

  1. 提取公钥以生成加密报告。
  2. 发送到广告技术平台服务器以进行收集、转换和分批处理的经过加密的可汇总报告。
  3. 广告技术平台服务器将报告(avro 格式)分批发送到已部署的汇总服务。(必须由广告技术平台完成)。
  4. 检索要解密的汇总报告。
  5. 从协调者检索解密密钥。
  6. 汇总服务会解密报告以进行汇总和添加噪声。
  7. 可汇总报告的会计核算服务会检查是否还有隐私预算可用于为给定的可汇总报告生成摘要报告。
  8. 提交最终摘要报告。

从该图表中,您可以了解汇总服务与主要客户端衡量 API Attribution Reporting APIPrivate Aggregation API 和协调程序之间的整体关系。

该流程从不同的效果衡量 API(例如 Attribution Reporting APIPrivate Aggregation API)开始,这些 API 会从多个浏览器实例生成报告。Chrome 会从协调器中的密钥托管服务获取公钥,以便在将报告发送到广告技术平台的报告来源之前对其进行加密。公钥每 7 天轮替一次。

广告技术平台的报告来源收到这些报告后,应配置报告来源以收集这些报告并将其转换为 avro 格式,然后发送到其部署的汇总服务实例。请查看批量处理策略

广告技术平台准备好分批处理后,会向汇总服务创建分批请求,汇总服务会通过从密钥托管服务检索解密密钥来解密报告,并对报告进行汇总和添加噪声以创建摘要报告。请注意,这取决于隐私预算是否足以生成最终摘要报告。

用于收集报告的广告技术平台报告来源端点由广告技术平台托管,汇总服务部署在广告技术平台的云端。

可汇总报告批处理

如果没有指定的报告来源服务器的帮助,报告流程将无法完成。这是广告技术平台在注册过程中提交的来源。报告来源负责执行的主要操作包括收集、转换和批量处理收到的可汇总报告,并准备将其发送到广告技术平台在 Google Cloud 或 Amazon Web Services 中部署的汇总服务。详细了解如何准备可汇总的报告

现在,您已经了解了基本概念,接下来我们来详细了解将在汇总服务中部署的组件。

Cloud 组件

汇总服务由各种云服务组件组成。提供的 Terraform 脚本会预配和配置所有必要的云服务组件。

汇总服务云端组件

前端服务

托管式云服务:Cloud Functions (Google Cloud) / API Gateway (Amazon Web Services)

前端服务是一种无服务器网关,可用作用于创建作业和检索作业状态的 Aggregation API 调用的入口点。它负责接收汇总服务用户的请求、验证输入参数并启动汇总作业调度流程。

前端服务中提供了两个 API:

端点 说明
createJob 此 API 会触发汇总服务作业。它需要包含用于触发作业的相关信息,例如作业 ID、输入存储空间详细信息、输出存储空间详细信息、报告来源等。
getJob 此 API 会返回指定作业 ID 的作业状态。它提供有关作业状态的信息,例如“已收到”“正在处理”或“已完成”。此外,如果作业已完成,则会显示作业结果,包括作业执行期间遇到的所有错误消息。

查看汇总服务 API 文档

作业队列

托管式云服务:Pub/Sub (Google Cloud) / Amazon SQS (Amazon Web Services)

作业队列是一个消息队列,用于存储汇总服务的作业请求。前端服务会将作业请求消息插入队列,然后汇总工作器会使用这些消息来处理作业请求。

Cloud Storage

托管式云服务:Google Cloud Storage(Google Cloud)/Amazon S3(Amazon Web Services) Cloud Storage 用于存储汇总服务使用的输入和输出文件(例如:加密报告文件、输出摘要报告等)。

作业元数据数据库

托管式云服务:Spanner(Google Cloud)/DynamoDB(Amazon Web Services)

作业元数据数据库存储和跟踪汇总作业的状态。数据库会记录创建时间、请求时间、更新时间和状态(例如“已收到”“正在处理”“已完成”等)等元数据。汇总工作器会在作业运行期间更新作业元数据数据库。

汇总 Worker

受管云服务:具有 Confidential Zone 的 Compute Engine(Google Cloud)/具有 Nitro Enclave 的 Amazon Web Services EC2(Amazon Web Services)

汇总工作器会处理由作业队列中的作业请求发起的作业请求,并使用从协调者中的密钥生成和分发服务 (KGDS) 提取的密钥解密加密输入。为了最大限度地缩短作业处理延迟时间,解密密钥会在汇总工作器中缓存 8 小时,可供该工作器实例处理的所有作业使用。

该工作器在可信执行环境 (TEE) 实例中运行。每个工作器一次只处理一个作业。广告技术平台可以通过设置自动扩缩配置,配置多个工作器以并行处理作业。通过自动扩缩,系统会根据作业队列中剩余的消息数量动态调整工作器数量。您可以通过 Terraform 环境文件配置自动扩缩的工作器数量下限和上限。如需详细了解自动扩缩,请参阅以下 Terraform 脚本。[Amazon Web Services / Google Cloud]

汇总 Worker 会调用可汇总报告会计核算服务,以进行可汇总报告会计核算。可汇总的报告会计服务可确保仅在未超出隐私预算限制时运行作业。(请参阅“不得有重复”规则)。如果有预算,系统会使用带噪声的汇总生成摘要报告。详细了解可汇总报告会计核算

汇总工作器会更新作业元数据库中的作业元数据,包括适当的作业返回代码和报告错误计数器(如果部分报告失败)。用户可以使用作业状态检索 API (getJob) 提取状态。

如需详细了解汇总服务,请参阅我们的说明文档

后续步骤

现在,您已经了解了汇总服务的要点,接下来可以通过 Google Cloud 或 Amazon Web Services 部署您自己的汇总服务实例了。如需了解如何操作已部署的汇总服务,请点击此链接,详细了解如何操作汇总服务开始使用

问题排查

如需详细了解错误消息、可能导致您遇到的错误的原因,以及采取的后续缓解措施,请参阅我们的常见错误代码和缓解措施文档。

获取支持和提供反馈

  • 如需提出产品问题、反馈和功能请求,请在我们的 GitHub 代码库中创建问题。
  • 如果您在使用汇总服务部署、维护或运行作业时遇到错误,请使用此技术支持表单请求技术问题排查支持。
  • 查看公开状态信息中心,了解已知问题。