面向技术决策者的 Attribution Reporting 关联服务简要概览。
借助 Attribution Reporting API,广告技术平台和广告主可以衡量 广告点击或观看带来了转化(例如购买)。此 API 依赖于 客户端和服务器端集成的组合,具体取决于您的 业务需求。
在继续学习之前,请务必阅读 Attribution Reporting 概览。 这将有助于您了解 API 的用途以及不同输出报告的流程 (事件级报告 和摘要报告)。 如果您遇到不熟悉的术语,请参阅 Privacy Sandbox 术语表。
本文的适用对象
如果您属于以下情况,则应阅读本文:
- 您是广告技术人员或广告客户的技术决策者。您可能在工作 运营、DevOps、数据科学、IT、营销或其他职位 您做出技术实现决策。您想知道这些 API 如何实现可保护隐私的衡量。
- 您是技术从业者(例如开发者、系统操作员 系统架构师或数据科学家) 此 API 和汇总服务环境。
在本文中,您将从头到尾简要地了解 服务适用于 Attribution Reporting API。如果您是技术人员 您可以 试用此 API 。
概览
Attribution Reporting API 包含许多服务,这些服务需要特定的 客户端配置和服务器部署。为了确定 首先:
- 做出设计决策。确定您要收集的信息,确定您希望从任意指定广告系列中获得哪些转化,并确定要收集的报告类型。最终会输出两种报告之一或两种报告:事件级报告和摘要报告。
通常有两个(有时是三个)组件协同发挥作用,以支持报告:
- 网站到浏览器的通信。在
基于 Cookie 的系统,因此转化和广告互动信息
供您或 Google Analytics 服务加入的标识符
事件。利用此 API,浏览器可将转化数据与
广告点击次数/浏览次数,具体取决于您的说明。
分析。因此,您的广告呈现代码和转化跟踪必须:
<ph type="x-smartling-placeholder">
- </ph>
- 告诉浏览器应将哪些转化归因于哪个广告 点击次数或展示次数。
- 发送信号,表明要包含在最终报告中的任何其他数据。
- 数据收集。您需要一个收集器端点 接收生成的报告。浏览器的输出 可以是两种可能的报告之一:事件级报告和可汇总报告 报告(经过加密,用于生成摘要报告)。
如果您收集了可汇总报告,还需要第三个组件:
- 生成摘要报告。批处理 使用汇总服务处理报告 生成摘要报告。
设计决策
Attribution Reporting 的一个关键原则是早期设计决策。由您决定 在哪些类别中收集哪些数据,以及处理这些数据的频率如何 数据。输出报告可提供有关广告系列或业务的数据分析。
输出报告可以是:
- 事件级报告会将特定的广告点击或观看(位于广告端)与转化端数据相关联。为了通过限制跨网站合并用户身份来保护用户隐私,转化端数据非常有限,并且数据很嘈杂(也就是说,在一小部分情况下,发送的是随机数据,而不是真实报告)。
- 摘要报告与广告方面的特定事件无关。这些报告可提供更详细的转化数据,并可灵活地将点击和浏览数据与转化数据合并起来。
您选择的报告决定了您需要收集哪些数据。
您还可以将最终输出看作工具的输入, 做出决策。例如,如果您要生成摘要报告以确定 很多转化带来了一些总支出价值,这可能有助于您的团队决定 为了提高总支出,您的下一个广告系列应以什么为目标。
确定了要衡量的指标后,您就可以设置 。
网站到浏览器的通信
<ph type="x-smartling-placeholder">![发布商网站上的归因来源与广告客户网站上的触发器相关联。](https://google-developers.gonglchuangl.net/static/privacy-sandbox/assets/images/attribution-sources-a-pu-b04d5ed143672.png?authuser=0&hl=nb)
归因事件流程
假设有一个展示广告的发布商网站。每个广告客户或广告技术提供商都希望了解用户与其广告的互动情况,并将转化归因于正确的广告。系统会按如下方式生成报告(包括事件级报告和可汇总报告):
在发布商网站上,广告元素(
<a>
或<img>
代码)配置了特殊属性attributionsrc
。其值为网址,例如https://adtech.example/register-source/ad_id=...
。下面是一个链接示例,点击链接就会注册一个来源:
<a href="https://shoes.example/landing" attributionsrc="http://adtech.example/register-source?..." target="_blank"> Click me</a>
下面是一个在被查看时会导致注册来源的图片示例:
<img href="https://advertiser.example/landing" attributionsrc="https://adtech.example/register-source?..."/>
或者,您也可以使用 JavaScript 调用代替 HTML 元素。
下面是一个使用
window.open()
的 JavaScript 示例。请注意,网址已经过网址编码,以避免特殊字符出现问题。const encodedUrl = encodeURIComponent( 'https://adtech.example/attribution_source?ad_id=...'); window.open( "https://shoes.example/landing", "_blank", attributionsrc=${encodedUrl});
- 当用户点击或查看广告时,浏览器会向
attributionsrc
(通常是广告主或广告技术提供商端点)发送GET
请求。 收到此请求后,广告客户或广告技术提供商决定指示浏览器针对与广告的互动注册来源事件,以便稍后可以将转化归因于此广告。为此,广告客户或广告技术提供商需要在响应中添加一个特殊的 HTTP 标头。此类自定义数据会附加到此标头自定义数据中,以提供来源事件(广告点击或观看)的相关信息。如果此广告最终发生了转化,这些自定义数据最终将显示在归因报告中。
随后,用户访问广告客户的网站。
在广告客户网站的每个相关网页(例如购买确认页或产品页)上,转化像素(
<img>
元素)或 JavaScript 调用会向https://adtech.example/conversion?param1=...¶m2=...
发出请求。此网址对应的服务(通常是广告客户或广告技术提供商)会收到请求。它决定将此行为归类为转化,因此需要指示浏览器记录一次转化,即触发归因。为此,广告客户或广告技术提供商需要在对像素请求的响应中添加一个特殊的 HTTP 标头,该标头包含有关转化的自定义数据。
用户本地设备上的浏览器收到此响应,并将转化数据与原始来源事件(广告点击或观看)进行匹配。有关详情,请参阅将来源与触发器匹配
浏览器安排向
attributionsrc
发送报告。该报告包括:- 广告技术提供商或广告客户在第 3 步中附加到来源事件的自定义归因配置数据。
- 第 6 步中的自定义转化数据集。
之后,浏览器将报告发送到
attributionsrc
中定义的端点,同时存在一些延迟和噪声。可汇总的报告会加密,而事件级报告则不会。
归因触发器(广告客户的网站)
归因触发器 是指示浏览器捕获转化的事件。
我们建议捕获对您的业务而言最重要的转化, 例如购买您可以设定多个转化类型和元数据, 摘要报告中捕获的数据。
这可确保这些事件的汇总结果详细而准确。
将来源与触发器匹配
当浏览器收到归因触发器响应时,会访问 本地存储空间,以查找与归因触发器的 以及该网页网址的 eTLD+1。
例如,当浏览器从
在 shoes.example/shoes123
上 adtech.example
,浏览器会在
与 adtech.example
和 shoes.example
都匹配的本地存储空间。
您可以设置过滤条件(或自定义规则),以确定何时匹配触发器 特定来源。例如,设置一个过滤条件,以仅统计 特定商品类别,并忽略其他所有类别。过滤条件和 优先级模型可实现更高级的归因报告。
如果在本地存储空间中找到多个归因来源,浏览器会选择 最近存储的数据。在某些情况下 指定优先级后,浏览器会选择优先级最高的来源 优先级。
数据收集
与相应来源匹配的归因触发器一起以如下形式发送: 浏览器向广告技术平台拥有的服务器上的报告端点生成的报告 (有时称为收集端点或收集服务)。这些 报告可以是事件级报告,也可以是可汇总报告。
可汇总报告 用于生成摘要报告。可汇总的报告是 (在发布商的网站上)和转化数据(通过 (例如广告客户的网站)生成的。 在广告技术平台收集用户设备数据之前,先行收集。
事件级报告会延迟 2 到 30 天。可汇总报告 会在一小时内随机延迟发送,并且事件必须在 捐赠预算。 这些选择可以保护隐私,并防止任何个人用户的行为被利用。
如果您只对事件级报告感兴趣 所需的基础架构不过,如果您想生成摘要报告 您需要使用附加服务来处理可汇总报告。
生成摘要报告
要生成摘要报告,您需要使用 汇总服务 (由广告技术平台运营)来处理可汇总报告。聚合 服务会添加噪声以保护用户隐私,并返回最终摘要报告。
<ph type="x-smartling-placeholder">![系统收集可汇总报告,对其进行批处理,然后将其发送到广告技术环境。](https://google-developers.gonglchuangl.net/static/privacy-sandbox/assets/images/aggregatable-reports-are-a0830fd543e6f.png?authuser=0&hl=nb)
对收集的可汇总报告进行批处理后,系统会对该批次进行处理 由汇总服务提供答 协调员 仅向经过认证的汇总版本提供解密密钥 服务。然后,聚合服务会解密数据 并添加噪声,然后再以摘要报告的形式返回结果。
批量可汇总报告
在处理可汇总报告之前,必须对这些报告进行批量处理。批次 包含多个经过策略分组的可汇总报告。您的策略 可能会反映特定时间段(例如每天或每周)。这个 可以在同一台服务器上进行,该服务器就是您的报告端点。
批次应包含许多报告,以确保较高的信噪比。
<ph type="x-smartling-placeholder">![时间段越长,结果的噪声就越小。](https://google-developers.gonglchuangl.net/static/privacy-sandbox/assets/images/larger-periods-lead-les-4d4edffb3d2d6.png?authuser=0&hl=nb)
批处理周期可能随时更改,以确保捕获特定事件 预计销量会更高一些,例如一年一度的促销活动。批处理期 而无需更改归因来源或触发器。
汇总服务
汇总服务负责处理可汇总报告, 生成摘要报告。可汇总的报告会经过加密处理,只能 由汇总服务读取,汇总服务在可信执行环境中运行 (TEE)。
汇总服务向协调者请求解密密钥 解密和汇总数据解密并汇总后,结果 会发出噪声以保护隐私,并以摘要报告的形式返回。
从业者可以生成可汇总的明文报告, 在本地测试汇总服务。 或者,您也可以在 AWS 上使用 Nitro Enclaves 通过加密报告进行测试。
后续操作
我们希望与您交流互动,以确保我们构建的 API 人人皆宜。
讨论 API
与其他 Privacy Sandbox API 一样,此 API 记录在案, 公开讨论的内容。
试用此 API
您可以进行实验并参与实验 在有关 Attribution Reporting API 的对话中。