启用转化衡量

转化归因衡量可能涉及多方，包括发布商、广告客户、广告投放技术平台（投放广告的实体）、衡量服务提供商等。本文档将介绍常见的转化衡量场景，但总体而言，任何希望从 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 请求。

典型的广告系列设置可能如下所示：

1. 广告客户广告服务器 (3PAS) 会向 DSP 提供广告素材标记，其中包含第三方衡量服务提供商的展示和点击跟踪像素。广告服务器应确保广告素材标记中包含 attributionsrc。

2. DSP 提供用于添加其他用于衡量展示和点击跟踪像素的功能，并且应确保 attributionsrc 包含在它们用于出价的最终广告素材标记中。

场景 2：只有第三方衡量服务提供商需要从 Attribution Reporting API 接收报告

某广告客户希望使用第三方衡量服务提供商对广告资源上的转化进行归因，但托管广告素材的广告技术平台没有归因衡量要求。如果发布商、SSP 或发布商广告服务器托管了广告素材，不打算自行使用归因报告，但希望为其 DSP 合作伙伴或衡量代码植入公司（例如第三方广告服务器、衡量服务提供商或分析服务提供商）启用 Attribution Reporting API，这种情况很常见。

在这种情况下，负责在当前设置中触发点击和展示事件的一方需要向广告素材添加新的 attributionsrc 属性，并确保重定向按预期运行。这在很大程度上取决于每个发布商的集成情况，但对于点击事件，这可能是 SSP、广告投放技术平台或发布商本身。对于展示事件，这通常是第三方衡量服务提供商。

在场景 1 的典型广告系列设置示例中，发布商广告服务器、SSP 或发布商本身可能只需要确保 DSP 提供的 attributionsrc 属性能够显示在发布商页面上。

实现细节

下表简要说明了 Attribution Reporting API 实现步骤：

步骤	工作责任	示例
第 1 步：为现有广告素材和衡量代码启用归因来源	负责触发展示事件或处理点击事件的实体会添加 attributionsrc 属性。	对于点击事件，通常由呈现广告素材的买方（DSP/广告客户广告服务器）添加此属性。 对于展示事件，需求方平台 (DSP)、供应方平台 (SSP)、发布商、广告服务器或衡量服务提供商会添加此属性，具体取决于发布商的设置。 对于使用 VAST 格式的视频广告，发布商和视频 SDK 会添加该属性。
第 2 步：为第三方来源启用 Attribution Reporting	如果使用包含 302 重定向的现有重定向路径，此设置开箱即用。 如果无法使用 302 重定向，则可以使用 attributionsrc 属性列出多个广告技术平台服务器。	通常，只要将 attributionsrc 属性添加到广告素材，第三方重定向就会收到 Attribution Reporting API 调用。
第 3 步：为 Attribution Reporting API 请求设置响应	希望通过 Attribution Reporting API 接收报告的任何实体	广告主使用的 DSP 和第三方衡量服务提供商

请注意，每个步骤的具体情况取决于广告素材在发布商网页上的呈现和投放方式，以及哪些广告技术平台实体会收到 Attribution Reporting API 发送的报告。

重要提示 ：第三方衡量服务提供商应确保他们已注册，并且其服务器已准备好接收和响应 Attribution Reporting API 请求。

第 1 步：为现有广告素材和衡量代码启用归因来源

第一步，启用归因来源。

attributionsrc 属性的工作原理

新的 attributionsrc 属性指定 Attribution Reporting API 请求将发送到何处。负责触发展示事件和点击事件的实体必须使用 attributionsrc 属性更新广告素材。attributionsrc 应添加到现有的点击和展示事件中，可以为空或非空。

对于使用重定向的点击事件，应将 attributionsrc 属性添加到导航中。导航之后的任何 302 重定向都不需要添加 attributionsrc 属性，并且只要初始导航添加了 attributionsrc，就可以用于 ARA。

当 attributionsrc 为空时，ARA 请求将发送到锚标记 href 属性中定义的网址（点击后到达网址）。定义 attributionsrc 属性后，ARA 请求将发送到 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,   },   ... }; window.fetch("[IMPRESSION_URL]", options);

在 Protected Audience 竞价中启用归因来源注册

若要衡量 Protected Audience 竞价中的转化情况，您可以使用 registerAdBeacon/registerAdMacro 和 setReportEventDataForAutomaticBeacons/reportEvent 来注册归因来源，而不是使用 attributionsrc。

对于报告 Protected Audience 信号，registerAdBeacon 函数可在报告 Worklet 内使用，而 registerAdMacro 在买方的胜出报告 Worklet 中可用。然后，您可以使用 Fenced Frame Ads Reporting API 的 reportEvent 和 setReportEventDataForAutomaticBeacons 函数将广告框架内的事件数据添加到已注册的信标和宏中。这样，Protected Audience 报告 Worklet 的信号和广告素材框架事件载荷就能相互关联。

当从帧中调用 reportEvent 触发信标和宏时，或浏览器触发自动信标时，系统会将 Attribution-Reporting-Eligible HTTP 标头添加到请求中。您可以使用信标的响应来注册归因来源。信标请求可能会被重定向，以便进行第三方衡量。

注意 ：Fenced Frame Ads Reporting API 在 iframe 和围栏框架中均可用

如需深入了解，请参阅 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 附录包含每种情况的示例。

为了尽可能扩大覆盖面，在触发事件 ping 时，VAST 实现应默认使列出的所有事件都符合注册条件。例如，在触发 <Impression> 事件网址时，应对用于发送请求的 <img> 元素（或提取调用中的等效项）使用（空的）attributionsrc 属性，以始终允许接收方使用 Attribution Reporting API 注册该事件。

第 2 步：为第三方来源启用 Attribution Reporting

若要允许第三方使用 Attribution Reporting API，您可以使用现有的重定向或向 attributionsrc 属性添加第三方列表。在大多数情况下，每个广告技术平台都有自己的独立展示跟踪代码，因此重定向与点击跟踪广告代码的相关性更高。

处理现有重定向链中的第三方来源

在典型的广告点击中，许多点击跟踪广告代码可能会以一连串 302 重定向的形式出现在最终着陆页的导航过程中。如果原始点击目标带有 attributionsrc 注解或在 Protected Audience API 中向 registerAdBeacon/registerAdMacro 注册，则重定向链中的每个请求都符合在 Attribution Reporting API 中注册的条件。重定向链中的广告技术平台也必须已注册。

请注意，在重定向时不会发送初始请求的正文。对于 Protected Audience 竞价，如果传递给 reportEvent 的 eventData 且 setReportEventDataForAutomaticBeacons 需要在重定向过程中使用，则必须作为重定向网址的一部分明确传递。

在以下示例中，我们将使用广告投放技术平台 (serving-adtech.example) 和第三方衡量服务提供商 (3p-measurement.example) 作为想要生成和接收归因报告的两个不同实体。在此示例中，广告投放技术平台可以是在发布商网站上呈现广告素材的 DSP，它有自己的报告产品。第三方衡量服务提供商可以是广告客户用于生成转化报告的实体。

在来源注册时，执行以下步骤：

1. serving-adtech.example 用于设置广告素材中的 attributionsrc 属性。用户访问发布商页面，浏览器会向 serving-adtech.example. 发送请求
2. serving-adtech.example 使用 Attribution-Reporting-Register-Source 标头和 Location 标头进行响应。
   1. serving-adtech.example 使用 Attribution-Reporting-Register-Source 标头在响应中提供关于待注册来源的元数据。
   2. serving-adtech.example 使用 Location 标头包含指向 3p-measurement.example 的重定向。请注意，Location 标头可能已用于您的现有点击跟踪流程，以支持指向第三方的 302 重定向。
3. 浏览器接收来自 serving-adtech.example 的响应并解析 Attribution-Reporting-Register-Source 标头。浏览器会使用 serving-adtech.example 作为报告来源来存储来源事件。
4. 由于此请求是重定向请求，因此浏览器也会向 3p-measurement.example 发出新请求。
5. 3p-measurement.example 会返回包含 Attribution-Reporting-Register-Source 标头的响应。
6. 浏览器收到来自 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。发送到点击后到达网址的导航请求也可以注册归因来源。

警告 ：这些请求只会在支持 Attribution Reporting API 的浏览器上发送，并且在不支持的环境中可能会丢失。

第 3 步：为 Attribution Reporting API 请求设置响应

对于接收 Attribution Reporting API 请求的所有来源，请确保服务器使用适当的 Attribution-Reporting-Register-Source 标头进行响应。如需了解如何构建响应，请参阅注册来源指南和说明。

注册多个触发器

您可以通过在转化端添加多个像素元素（每个触发器一个）来注册多个归因触发器。attributionsrc 元素对于触发器注册是可选的。

您还可以使用重定向请求或在 attributionsrc 元素中列出多个网址（与注册来源时相同），从单个像素元素注册多个触发器。将匹配由相同来源生成的来源事件和触发器事件。