使用 Attribution Reporting API 和 Private Aggregation API 衡量跨用户汇总的数据。
实现状态
- 参与试用并试用归因报告摘要报告。
什么是摘要报告?
摘要报告是针对一组用户编写的,因此报告无法与任何个人联系起来。摘要报告可提供详细的转化数据,并能灵活地查看点击和查看数据。摘要报告不依赖可用于跨网站识别个别用户的第三方 Cookie 或机制。
在以下两种情况下创建摘要报告:
- 广告衡量:广告技术平台可以使用 Attribution Reporting 生成摘要报告,以衡量广告点击或观看何时在广告主网站上促成了转化(例如销售或注册)。广告技术平台还可以为使用不公开汇总的 Protected Audience API 竞价生成摘要报告。
- 常规跨网站报告:开发者在共享存储空间中捕获跨网站数据,并且可以使用不公开汇总功能针对这些数据生成报告。这有很多用途,例如深入了解用户受众特征以及捕获内容的唯一身份用户覆盖面。
对于归因报告和不公开汇总,摘要报告的请求方式有所不同。在了解如何生成报告之前,您必须先了解汇总是什么,以及如何使用摘要报告满足衡量需求。
主要概念
设计数据收集
摘要报告的一个主要原则是早期设计决策。您可以决定在哪些类别中收集哪些数据。输出报告提供有关广告系列或业务的数据洞见。
输出报告可提供详细的跨网站转化数据,而且可让您灵活地将点击和观看数据与转化数据合并。您还可以将最终输出视为做出决策时所用工具的输入内容。
问问自己:对于用户与我的内容的互动情况,我想了解什么?
广告转化次数
例如,如果您生成摘要报告以确定有多少转化带来了一些总支出价值,这可能有助于您的团队决定下一个广告系列应以什么为目标来产生更高的总支出。
跨网站互动
例如,如果您生成摘要报告以确定有多少人在第三方网站上阅读了您的内容,这可能有助于您的团队决定如何与该第三方合作来提高互动度,并鼓励读者直接访问您的网站。
浏览器会捕获哪些信息?
可汇总报告是从用户浏览器捕获的原始数据,其中包括一组预定的存储分区(或汇总键)。如何确定此条件取决于您的设计决策。
摘要报告汇总了汇总数据和详细转化数据。
广告转化次数
转化次数由广告客户或广告技术公司定义,可能会因广告系列而异。一个广告系列可以衡量用户在购买广告所宣传的商品后产生的广告点击次数。另一个广告系列可以衡量有多少广告浏览为广告客户的网站带来了访问。
例如,某广告技术提供商在 news.example 上投放广告系列,其中转化表示用户点击穿鞋广告,然后在 shoes.example 上完成了鞋购买。
广告技术平台收到这个 ID 为 1234567
的广告系列的摘要报告,其中指出 2022 年 1 月 12 日在 shoes.example 上发生了 518 次转化,总支出为 38,174 美元。60% 的转化来自购买带有产品 SKU 9872
的蓝色运动鞋的用户,40% 来自购买带有产品 SKU 2643
的黄色凉鞋的用户。广告系列 ID 是详细的广告端数据,而产品 SKU 是详细的转化数据。转化次数和总支出是汇总数据。
跨网站互动
在捕获数据之前,您必须定义要收集哪些信息、指明您希望通过任何给定跨网站集成获得哪些转化,以及确定要收集的报告类型。
非公开汇总文档中详细说明了多种可能的用例。我们来看一个示例:
您可能希望衡量在不同网站上看过您的内容的用户的受众特征。不公开汇总可以提供答案,例如“大约 317 名 18-45 岁的唯一身份用户来自德国”。首先,明确您想要收集哪些信息(例如年龄和位置)。然后,使用共享存储空间从第三方网站收集该特定受众特征数据。稍后,您可以通过不公开汇总提交报告,其中包含使用汇总键编码的年龄段和国家/地区维度。
如何在汇总之前收集数据?
摘要报告由来自一组独立设备的汇总数据组成。虽然无法观察和查看单个用户的操作,但收集过程对于每个人都是一样的。
系统会对单个用户的操作进行加密,并收集到可汇总报告中。这些报告还包含少量与批处理相关的未加密元数据。
对于归因报告数据,可按如下方式获取可汇总报告:
- 用户访问发布商网站,查看或点击广告,也称为归因来源事件。
- 用户发生转化的几分钟或几天后,也称为归因触发器事件。例如,转化可以定义为产品购买。
- 浏览器软件会将广告点击或观看与转化事件进行匹配。根据此匹配,浏览器会使用广告技术提供商创建的特定逻辑创建可汇总的报告。
- 浏览器会对这些数据进行加密,并在短暂延迟后将其发送到广告技术服务器进行收集。广告技术服务器必须依赖汇总服务才能访问添加了噪声的数据分析。
对于不公开汇总,其内容如下所示:
- 第三方决定他们要衡量的对象,并将数据写入共享存储空间以供日后读取。
- 用户触发符合第三方想要衡量的事件。例如,当用户访问包含嵌入式内容的网站时,第三方可以读取共享存储空间中的数据,并使用不公开汇总将加密的可汇总报告发送到您的服务器进行收集。
批量处理可汇总报告
必须先对收集的可汇总报告进行处理,并将其汇总到摘要报告中。批量报告是指由可汇总的报告构成的策略性群组。
可汇总的报告包含少量未加密的数据(以 shared_info
形式包含),这些数据可用于创建批次。其中包括时间戳和报告来源。您无法根据报告中的加密信息进行批量处理。
理想情况下,一个批次会包含许多报告。您可以选择每小时、每天、每周或任何其他时间范围的批量处理。对于预计流量较多的特定事件,此策略可作出调整。
例如,在针对 Attribution Reporting API 批量处理可汇总报告时,您可能会决定在大促销当天将批量处理策略更新为每小时一次,此时您会希望获得较多的广告转化量。
使用 Private Aggregation API 时,您可能会在关于嵌入第三方网站的特定内容的大型新闻稿发布当天改变您的策略。
使用汇总服务处理数据
汇总服务会解密和合并可汇总报告中的批量数据,添加噪声,然后返回最终的摘要报告。此服务在可信执行环境 (TEE) 中运行,该环境部署在支持必要安全措施保护这些数据的云服务上。
包含归因报告的摘要报告
如需让广告技术提供商检索摘要报告,必须执行以下步骤:
- 广告技术提供商从各个用户的浏览器收集可汇总报告。
- 广告技术提供商会批量生成可汇总报告,然后将这些批量报告发送到汇总服务。
- 汇总服务安排一个 worker 来汇总数据。
- 汇总工作器解密和汇总可汇总报告中的数据,以及添加了噪声的数据。
- 汇总服务将摘要报告返回给广告技术提供商。
广告技术平台可以使用摘要报告为出价提供参考,并向自己的客户提供报告。建议使用 JSON 编码方案摘要报告格式。
包含不公开汇总的摘要报告
- 读取共享存储空间收集的跨站点数据,并生成汇总键以对数据进行分组。
- 使用汇总键和要累积的值,从共享存储空间 Worklet 调用 Private Aggregation API。浏览器会根据您的输入生成加密的可汇总报告,并将其发送到您的服务器进行收集。
- 对可汇总报告进行批处理,并将其发送到汇总服务进行处理。
- 汇总服务会处理批量生成的报告,然后添加噪声。
- 汇总服务将摘要报告返回给请求者。
互动和分享反馈
摘要报告是 Privacy Sandbox 衡量提案的关键组成部分。与其他 Privacy Sandbox 提案一样,GitHub 上对此进行了公开记录和讨论。
- 讨论 Attribution Reporting API。
- 讨论 Private Aggregation API。
- 开发者支持:在 Privacy Sandbox 开发者支持代码库中提问和加入讨论。