启用转化衡量

转化归因衡量可能涉及多个方，包括发布商、广告客户、广告投放技术平台（投放广告的实体）、衡量服务提供商等。本文档介绍了常见的转化衡量场景，但一般来说，任何希望通过 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 步：为第三方来源启用归因报告 如果使用带有 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 调用的选项参数中包含 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 信号，请在报告 Worklet 内使用 registerAdBeacon 函数，并在买方的胜出报告 Worklet 内使用 registerAdMacro。然后，您可以使用 Fenced Frame Ads Reporting API 的 reportEvent 和 setReportEventDataForAutomaticBeacons 函数，将广告框架内的事件数据添加到已注册的信标和宏。这样一来，Protected Audience 报告 Worklet 的信号和广告素材框架事件载荷就可以相互关联。

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

如需深入了解，请参阅 Fenced Frame Ad Reporting API 说明文档中的“支持归因报告”部分。

为 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 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。发送到点击后到达网址的导航请求也符合注册归因来源的条件。

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

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

注册多个触发器

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

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