汇总服务

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

实现状态

可用性

提案 状态
针对 Attribution Reporting API、Private Aggregation API 中的 Amazon Web Services (AWS) 提供汇总服务支持
说明		 可用
跨 Attribution Reporting API、Private Aggregation API 为 Google Cloud 提供汇总服务支持
说明文档		 可用
汇总服务网站注册和多源汇总。网站注册包括将网站映射到云账号（AWS 或 GCP）。若要汇总多个源站，这些源站必须属于同一个网站。
GitHub 上的常见问题解答
网站汇总 API 文档 		可用
汇总服务的 epsilon 值将保持一个不超过 64 的范围，以方便对不同参数的实验和反馈。
提交 ARA 小数值反馈。
提交 PAA 小数值反馈。		 可用。在更新 epsilon 范围值之前，我们会提前通知整个生态系统。
为汇总服务查询提供更灵活的贡献过滤功能
解说		 可用
灾难后（错误、配置错误等）的预算恢复流程
解说		 提供
机制，用于审核广告技术平台使用预算挽回功能找回的共享 ID 所占百分比，以及针对 2025 年上半年计划恢复的过多账号恢复请求暂停未来恢复机制
Accenture 是 AWS 协调者之一
开发者博客		 可用
担任 Google Cloud 协调员之一的独立方
开发者博客		 可用
汇总服务对 Attribution Reporting API 上的汇总调试报告的支持
说明		 可用

关键术语和概念

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

术语 说明
汇总服务 由广告技术平台运营的服务，用于处理可汇总报告以创建摘要报告。
可汇总的报告

可汇总报告是从各个用户设备发送的加密报告。这些报告包含有关跨网站用户行为和转化的数据。转化（有时称为归因触发器事件）和关联的指标由广告主或广告技术平台定义。每个报告都会加密，以防止多方访问基础数据。

详细了解可汇总的报告。
可汇总报告的会计核算 位于两个协调器中的分布式账本，用于跟踪分配的隐私预算并强制执行“无重复”规则。这是一种隐私保护机制，位于协调者中并在其中运行，可确保通过汇总服务传递的报告不会超出分配的隐私预算。 详细了解批处理策略与可汇总报告的关系。
可汇总报告的会计核算预算 对预算的引用，用于确保报告不会被处理多次。
可信执行环境 (TEE)

可信执行环境是计算机硬件和软件的一种特殊配置， 验证计算机上运行的软件的确切版本。TEEs 允许外部各方验证软件是否完全按照 软件制造商声称可以，不多或少。

如需详细了解用于 Privacy Sandbox 提案的 TEE，请参阅 Protected Audience API 服务说明文档 以及汇总服务说明。
协调员

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.
共享 ID 计算值，由以下各项组成：shared_info、reporting_origin、destination_site（仅适用于 Attribution Reporting API）、source_registration-time（仅适用于 Attribution Reporting API）、scheduled_report_time、version。 这意味着，如果多个报告具有相同的 shared_info 字段属性，则它们属于同一共享 ID。这在可汇总报告会计中起着重要作用。 详细了解可信服务器。
汇总报告

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

报告来源是接收可汇总报告的实体，也就是调用 Attribution Reporting API 的广告技术平台。可汇总报告的来源 将用户设备转到与报告关联的已知网址 来源。此报告来源应在注册期间指定。
贡献债券 可汇总的报告可以包含任意数量的计数器增量。例如，报告中可能包含用户在广告客户网站上查看过的商品数量。与单个来源事件相关的所有可汇总报告中的增量之和不得超过给定限制“L1=2^16”。 如需了解详情，请参阅可汇总报告说明。
噪声和缩放 在汇总过程中，系统会向摘要报告添加一定量的统计噪声，这也有助于保护隐私并确保最终报告提供匿名化效果衡量信息。详细了解加法噪声机制，该机制是从拉普拉斯分布中提取的。
证明

认证是一种用于对软件身份进行身份验证的机制，通常使用加密哈希或签名。对于汇总服务方案，证明会将广告技术平台运营的汇总服务中运行的代码与开放源代码进行匹配。

详细了解证明。

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

汇总用例

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

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

端到端流程

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

端到端汇总服务流

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

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

该流程从不同的效果衡量 API（例如 Attribution Reporting API 或 Private 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 代码库中创建问题。
  • 如果您在使用汇总服务部署、维护或运行作业时遇到错误，请使用此技术支持表单请求技术问题排查支持。
  • 查看公开状态信息中心，了解已知问题。