启用转化衡量

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

某广告客户希望使用第三方衡量服务提供商来对广告资源中的转化进行归因，但托管广告素材的广告技术平台没有归因衡量要求。对于托管广告素材但不打算自行使用 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 发送的报告。

第 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 的展示事件应在传递给 fetch 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 函数可在报告工作程序中调用，而 registerAdMacro 可在买方的胜出报告工作程序中调用。然后，可以使用 Fenced Frame Ads Reporting API 的 reportEvent 和 setReportEventDataForAutomaticBeacons 函数将广告框架内的事件数据添加到已注册的信标和宏中。这样一来，Protected Audience 报告工作程序的信号和广告素材框架事件载荷就可以相互关联。

当信标和宏由来自框架的 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> 元素（或 fetch 调用中的等效元素）上使用（空）attributionsrc 属性，以便接收方始终能够通过 Attribution Reporting API 注册该事件。

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

如需允许第三方使用 Attribution Reporting API，您可以使用现有重定向，也可以向 attributionsrc 属性添加第三方列表。在大多数情况下，每个广告技术平台都有自己的独立展示跟踪器，因此重定向更适合点击跟踪器。

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

在典型的广告点击后到达流程中，可能会存在许多点击跟踪器，它们会形成一个302重定向链，作为导航到最终着陆页的一部分。如果原始点击目标网址已使用 attributionsrc 注释或已在 Protected Audience API 中注册 registerAdBeacon/registerAdMacro，则重定向链中的每个请求都符合通过 Attribution Reporting API 进行注册的条件。重定向链中的广告技术平台也必须已加入。

请注意，重定向时不会发送初始请求的正文。对于 Protected Audience 竞价，如果 eventData 传递到 reportEvent，并且 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。发送到点击后到达网址的导航请求也符合注册归因来源的条件。

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

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

注册多个触发器

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

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