转化归因衡量可能会涉及多方,包括发布商、广告主、广告投放技术平台(投放广告的实体)、衡量服务提供商等。在本文档中,我们展示了常见的转化衡量场景,但一般来说,希望从 Attribution Reporting API (ARA) 接收归因报告的一方必须确保遵循本文档中所述的集成步骤。
例如,发布商通常会有一个或多个广告技术平台来负责投放广告,这可能包括负责为广告素材提供标记的各方、负责在广告素材上提供展示像素或跟踪像素的各方,以及为发布商网页上的广告位提供 SDK 或代码的各方。这些广告技术平台可能(也可能不想)接收 ARA 的归因报告,但已做出调整,以确保下游广告技术平台可以接收归因报告。
此外,广告客户还可以使用第三方转化衡量服务提供商来进行跨广告网络归因以及其他报表功能。广告客户可以使用这些数据来了解多个独特发布商和渠道的广告投资回报率,因此,DSP 或广告服务器必须了解如何启用 Attribution Reporting API 来支持这些用例,这一点非常重要。希望使用第三方的广告客户可以继续使用第三方衡量服务提供商,或者设置内部服务器以注册并通过该 API 接收报告。
借助 Attribution Reporting API,多个广告技术平台可以为同一展示或转化注册归因来源和触发器,并从该 API 接收单独的报告。例如,DSP 可以通过 Attribution Reporting API 接收自己的归因报告,还可以为广告客户的第三方衡量服务提供商提供单独的报告。广告技术平台必须同时注册归因来源和触发器才能接收来自该 API 的报告,并在广告技术平台已单独向该 API 注册的归因来源和触发器间完成归因。
常见的转化衡量场景
在本部分,我们将介绍转化衡量的两种常见场景。
场景 1:广告投放技术平台和第三方衡量服务提供商都需要从 Attribution Reporting API 接收报告
广告客户希望使用第三方衡量服务提供商对广告资源上的转化进行归因,而托管广告素材的广告技术平台则希望在广告资源上进行转化归因。这对 DSP 或广告主广告服务器(第三方广告服务器 - 3PAS)来说十分常见,他们为广告素材提供标记、自行生成归因报告,并与与第三方衡量或分析服务提供商集成的广告主合作。
在这种情况下,广告投放技术平台也是在当前设置中负责触发点击和展示事件的一方。广告投放技术平台应在适当的位置设置新的 attributionsrc
,并确保重定向配置正确。此外,广告投放技术平台和第三方衡量服务提供商都应确保其已注册,并且其服务器已准备好接收和响应 Attribution Reporting API 请求。
典型的广告系列设置如下所示:
广告客户广告服务器 (3PAS) 向 DSP 提供广告素材标记,其中包括第三方衡量服务提供商的展示跟踪像素和点击跟踪像素。广告服务器应确保广告素材标记中包含
attributionsrc
。DSP 提供用于添加额外的衡量展示和点击跟踪像素的功能,并且应确保在出价时使用的最终广告素材标记中添加
attributionsrc
。
场景 2:仅第三方衡量服务提供商需要接收来自 Attribution Reporting API 的报告
某广告客户希望使用第三方衡量服务提供商对广告资源上的转化进行归因,但托管相应广告素材的广告技术平台对归因衡量没有要求。对于托管广告素材且不打算自行使用归因报告,但又希望为其 DSP 合作伙伴或衡量代码植入公司(例如第三方广告服务器、衡量或分析服务提供商)启用 Attribution Reporting API 的发布商、SSP 或发布商广告服务器较为常见。
在这种情况下,在当前设置中负责触发点击和展示事件的一方需要向广告素材添加新的 attributionsrc
属性,并确保重定向按预期运行。这在很大程度上取决于每个发布商的集成情况,但对于点击事件,可能是 SSP、广告投放技术平台或发布商本身。对于展示事件,这通常是指第三方衡量服务提供商。
在场景 1 的典型广告系列设置示例中,发布商广告服务器、SSP 或发布商本身可能只需要确保 DSP 提供的 attributionsrc
属性能够添加到发布商网页上。
实现细节
下表简要介绍了 Attribution Reporting API 实现步骤:
步骤 | 工作责任 | 示例 |
---|---|---|
第 1 步:为现有广告素材和衡量代码启用归因来源 | 负责触发展示事件或处理点击事件的实体添加了 attributionsrc 属性。 |
对于点击事件,通常由呈现广告素材的买方(DSP/广告客户)添加此属性。
对于展示事件,需求方平台 (DSP)、供应方平台 (SSP)、发布商、广告服务器或衡量服务提供商会添加此属性,具体取决于发布商的设置。 对于采用 VAST 格式的视频广告,发布商和视频 SDK 均需添加此属性。 |
第 2 步:为第三方来源启用归因报告 | 如果使用的是包含 302 重定向的现有重定向路径,便可直接使用。 如果无法使用 302 重定向,可以使用 |
通常,只要将 attributionsrc 属性添加到广告素材中,第三方重定向就会收到 Attribution Reporting API 调用。 |
第 3 步:设置针对 Attribution Reporting API 请求的响应 | 希望从 Attribution Reporting API 接收报告的任何实体 | 广告客户所用的 DSP 和第三方衡量服务提供商 |
请注意,每个步骤的具体细节取决于广告素材在发布商页面上的呈现和投放方式,以及哪些广告技术实体会收到 Attribution Reporting API 发送的报告。
第 1 步:为现有广告素材和衡量代码启用归因来源
第一步,启用归因来源。
attributionsrc
属性的工作原理
新的 attributionsrc
属性指定了 Attribution Reporting API 请求的发送目的地。负责触发展示事件和点击事件的实体必须使用 attributionsrc
属性更新广告素材。attributionsrc
应添加到现有的点击事件和展示事件中,可以为空或非空。
对于使用重定向的点击事件,应向导航栏中添加 attributionsrc
属性。导航之后的任何 302 重定向都不需要添加 attributionsrc
属性,并且只要初始导航添加了 attributionsrc
,就符合使用 ARA 的条件。
当 attributionsrc
为空时,系统会将 ARA 请求发送到在锚标记(点击后到达网址)的 href
属性中定义的网址。定义 attributionsrc
属性后,ARRA 请求会发送到 attributionsrc
属性中定义的网址。点击后到达网址还可以注册来源。
通常,如果托管点击后到达网址的服务器可以接收和响应 Attribution Reporting API 请求,则应使用空的 attributionsrc
属性。如果您希望 Attribution Reporting API 请求发送到其他服务器,请定义您自己的 attributionsrc
网址。
空 attributionsrc
属性示例:
您的现有设置 | 集成 ARA |
---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
|
如果 attributionsrc
属性为空,系统会将 Attribution Reporting API 请求发送到锚标记 href
属性所定义的网址。
非空 Attributionsrc 属性示例:
您的现有设置 | 集成 ARA |
---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc="[ATTRIBUTION_SRC_URL]">...</a>
|
当 attributionsrc
不为空时,系统会将 Attribution Reporting API 请求发送到 attributionsrc
代码定义的网址。点击后到达网址还可以注册来源。
为点击和展示事件添加了 attributionsrc
- 点击事件:
- 负责添加
attributionsrc
的实体通常是广告投放技术平台 - 包含点击事件的锚标记应添加
attributionsrc
属性 - 使用
window.open
的点击应使用window.open
调用的windowFeatures
参数来指定归因来源。
- 负责添加
- 展示事件:
- 负责添加
attributionsrc
的实体通常是广告投放技术平台和衡量服务提供商 - 通过
<img>
代码或<script>
代码触发的展示事件应包含attributionsrc
属性。 - 对于使用 Fetch API 的展示事件,应在传递给提取 API 调用的 options 参数中添加
attributionReporting
对象。
- 负责添加
有关点击和展示事件所需修改的摘要,请参阅下表:
事件 | 标记 | 您的现有设置 | ARA 集成之后 |
---|---|---|---|
点击 | HTML |
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc>...</a>
|
JavaScript | window.open('[CLICKTHROUGH_URL]', '_blank'); |
window.open('[CLICKTHROUGH_URL]', '_blank', 'attributionsrc'); |
|
展示 | HTML <img> 标记 |
<img src="[IMPRESSION_URL]" />
|
<img src="[IMPRESSION_URL]" attributionsrc />
|
HTML <script> 标记 |
<script src="[IMPRESSION_URL]"></script>
|
<script src="[IMPRESSION_URL]" attributionsrc></script>
|
|
JavaScript |
const options = {...} window.fetch("[IMPRESSION_URL]", options);
|
const options = { attributionReporting: { eventSourceEligible: true, triggerEligible: false, }, // ... }
|
在 Protected Audience 竞价中启用归因来源注册
如需衡量 Protected Audience 竞价中的转化,您可以使用 registerAdBeacon
/registerAdMacro
和 setReportEventDataForAutomaticBeacons
/reportEvent
来注册归因来源,而不是使用 attributionsrc
。
对于报告 Protected Audience 信号,registerAdBeacon
函数在报告 Workerlet 内可用,registerAdMacro
在买方的胜出报告 Worklet 内可用。然后,您可以使用 Fenced Frame Ads Reporting API 的 reportEvent
和 setReportEventDataForAutomaticBeacons
函数将广告帧内的事件数据添加到已注册的信标和宏中。这样一来,Protected Audience 报告 Worklet 的信号与广告素材帧事件载荷的信号就能相互关联。
当信标和宏由帧中的 reportEvent
调用触发,或浏览器触发自动信标时,系统会将 Attribution-Reporting-Eligible
HTTP 标头添加到请求中。您可以使用信标的响应来注册归因来源。信标请求可被重定向以允许第三方测量。
如需深入了解,请参阅 Fenced Frame Ad Reporting API 说明文档中的“对 Attribution Reporting 的支持”部分。
为 VAST 格式启用归因报表
VAST 是一种用于投放和衡量视频广告资源的通用格式,该标准中定义的许多事件都应被视为符合 Attribution Reporting API 注册的潜在来源事件。针对归因报告支持的 VAST 附录对此进行了详细说明,但简而言之,所有 <Tracking>
、<Impression>
、<*ClickThrough>
和 <*ClickTracking>
事件都是潜在的归因来源事件。所有 VAST 实施都应提供这些事件的注册资格覆盖率。
VAST 附录为这些元素定义了新属性,以允许设置专门为归因注册的次要网址。当事件包含 attributiontype="DOUBLE_PING"
和 attributionsrc="[URL]"
时,触发该事件的代码应在启用 Attribution Reporting API 时使用 [URL]
作为 attributionsrc
属性的值。VAST 附录包含每种情形的示例。
为确保尽可能扩大覆盖范围,VAST 实现在触发事件 ping 时,应默认使列出的所有事件都符合注册条件。例如,在触发 <Impression>
事件网址时,应该对用于发送请求的 <img>
元素(或提取调用中的等效属性)使用(空的)attributionsrc
属性,以便始终允许接收方通过 Attribution Reporting API 注册该事件。
第 2 步:为第三方来源启用归因报告
若要允许第三方使用 Attribution Reporting API,您可以使用现有重定向或向 attributionsrc
属性添加第三方列表。在大多数情况下,每个广告技术平台都有其独立的展示跟踪器,因此重定向与点击跟踪广告代码的相关性更高。
处理现有重定向链中的第三方来源
在典型的广告点击过程中,许多点击跟踪广告可能会以一系列 302
重定向的形式出现,这些重定向是前往最终着陆页的一部分。如果原始点击目标带有 attributionsrc
注解或使用 Protected Audience API 中的 registerAdBeacon/registerAdMacro
注册,重定向链中的每个请求都符合向 Attribution Reporting API 注册的条件。重定向链中的广告技术平台也必须已注册。
请注意,在重定向时不会发送初始请求的正文。对于 Protected Audience 竞价,如果传递到 reportEvent
和 setReportEventDataForAutomaticBeacons
的 eventData
需要在重定向过程中使用,则必须将其作为重定向网址的一部分明确传递。
在下面的示例中,我们会将广告投放技术平台 (serving-adtech.example
) 和第三方衡量服务提供商 (3p-measurement.example
) 用作两个不同实体,它们分别希望生成和接收归因报告。本例中的广告投放技术平台可以是在发布商网站上呈现广告素材并拥有自己的报告产品的 DSP。第三方衡量服务提供商可以是广告客户用于生成转化报告的实体。
在来源注册时,会执行以下步骤:
serving-adtech.example
设置广告素材中的attributionsrc
属性。用户访问发布商页面,浏览器向serving-adtech.example.
发送请求serving-adtech.example
会返回Attribution-Reporting-Register-Source
标头和Location
标头。serving-adtech.example
会使用Attribution-Reporting-Register-Source
标头来响应要注册的来源的相关元数据。serving-adtech.example
使用Location
标头来包含指向3p-measurement.example
的重定向。请注意,您的现有点击跟踪流程可能已使用Location
标头来支持将302
重定向到第三方。
- 浏览器接收来自
serving-adtech.example
的响应并解析Attribution-Reporting-Register-Source
标头。浏览器使用serving-adtech.example
作为报告来源来存储来源事件。 - 由于该请求是重定向,因此浏览器还会向
3p-measurement.example
发出新请求。 3p-measurement.example
会返回包含Attribution-Reporting-Register-Source
标头的响应。- 浏览器从
3p-measurement.example
收到此响应并读取Attribution-Reporting-Register-Source
。浏览器使用3p-measurement.example
作为报告来源来存储来源事件。
对于不在重定向链中的第三方来源,请使用 attributionsrc
如果多个报告程序来源想要针对导航事件注册一个来源,但出于任何原因无法在重定向链中显示,您可以在 attributionsrc
中将多个网站列为归因来源,作为替代解决方案。
您的现有设置 | 有 ARA 修改功能 |
---|---|
<a href="[CLICKTHROUGH_URL]">...</a>
|
<a href="[CLICKTHROUGH_URL]" attributionsrc="[REPORTING_URL_1] [REPORTING_URL_2]"></a>
|
在此示例中,Attribution Reporting API 符合条件的请求会同时发送到 REPORTING_URL_1
和 REPORTING_URL_2
。发送到点击后到达网址的导航请求也可以注册归因来源。
第 3 步:设置针对 Attribution Reporting API 请求的响应
对于接收 Attribution Reporting API 请求的所有源,请确保服务器使用适当的 Attribution-Reporting-Register-Source
标头进行响应。如需了解如何构建响应,请参阅注册来源指南和解释器。
注册多个触发器
您可以通过在转化端添加多个像素元素(每个触发器一个)来注册多个归因触发器。attributionsrc
元素对于触发器注册是可选的。
您还可以使用重定向请求或在 attributionsrc
元素中列出多个网址,注册单个像素元素的多个触发器,方法与注册来源时相同。将匹配由同一来源生成的来源事件和触发器事件。