此页面由 Cloud Translation API 翻译。

使用归因范围在归因之前过滤来源
使用集合让一切井井有条根据您的偏好保存内容并对其进行分类。

归因范围允许 API 调用方在来源和触发器注册期间指定一个字符串列表，以便在进行归因之前进行过滤。这样可以实现更精细的过滤，从而提高 API 效率并提供更大的灵活性。例如，它支持区分地跟踪同一网站上的不同广告客户。这还便于跟踪单个广告横幅中的多个广告系列或产品。

归因范围是可选字段，可在来源和触发器注册期间设置。在归因过程中，只有归因范围值包含触发器的归因范围值之一的来源才会被考虑进行归因。如果未在触发器中指定范围，则系统会考虑所有来源。在继续之前，您应该先熟悉 Attribution Reporting API 和高级过滤条件。

在来源注册期间

将可选参数 attribution_scopes 添加到标头 Attribution-Reporting-Register-Source，其中包含两个必需参数：values 和 limit；以及一个可选参数：max_event_states。

limit：表示报告来源的每个目标允许的不同范围的总数。所有与报告来源和目标位置相同但上限较低的现有已注册来源都将被删除。
values：表示特定来源的归因范围列表。这些值必须是字符串，且长度不得超过 50。
max_event_states（可选）：表示 API 调用方计划在所有后续事件来源注册中使用的事件状态的数量上限。请注意，如果报告来源和目标相同但 max_event_states value 不同的所有现有已注册来源都会被删除。此可选字段的默认值为 3。

来源注册示例

  Attribution-Reporting-Register-source: {
  //optional
  "attribution_scopes":{
  "limit": <int>,
  "values": <list of strings>,
  // optional
  "max_event_states": <int>
    },
  ...
  }

在触发器注册期间

在触发器注册期间，系统会向标头 Attribution-Reporting-Register-Trigger 添加可选参数 attribution_scopes。确保参数值是表示触发器范围的字符串列表。该触发器只会与 attribution_scopes 值参数包含触发器的 attribution_scopes（如果指定）中的至少一个来源匹配。

触发器注册示例

Attribution-Reporting-Register-Trigger: {
//optional
"attribution_scopes": <list of strings>,
...
}

归因范围示例

以下示例展示了在使用归因范围时将触发器归因于来源的情况。

来源注册 1

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser1"],
  "max_event_states": 3
  },
  ...
  }

来源注册 2

  Attribution-Reporting-Register-source: {
  "destination": "https://trigger.example",
  "attribution_scopes": {
  "limit": 2,
  "values": ["advertiser2"],
  "max_event_states": 3
  },
  ...
  }

触发器注册

  Attribution-Reporting-Register-Trigger: {
  "attribution_scopes": ["advertiser1"],
  ...
  }

触发器注册时，API 会选择要考虑用于归因的来源，这些来源的 attribution_scopes 值与触发器注册中的值相交。匹配的来源注册将继续完成其余归因流程。在此示例中，API 调用方将收到一份归因报告，将触发器注册归因于第一个来源注册。

归因范围与过滤条件

虽然归因范围和过滤条件的功能看起来可能很相似，但区别在于它们在触发器注册流程中的应用位置。归因范围过滤会在归因之前进行。也就是说，它会根据来源的范围与触发器中找到的范围是否相交，缩减具有相同目标网站和报告来源且未过期的候选来源的池。不过，顶级过滤条件是在触发器归因于单个来源后应用的。如果来源过滤条件和触发器过滤条件不重叠，则系统不会生成任何报告。

下图显示了一组具有相同目标网站、报告来源且未过期的来源和触发器。我们将简要介绍归因范围和过滤条件的使用方式，以及系统是否会根据可用来源和触发器生成报告。

归因前

来源 1 被滤除，因为其归因范围与触发器的范围 casualwear 不匹配。即使在所有可用来源中具有最高优先级，也无法阻止系统滤除该来源，因为在检查优先级之前会进行归因前过滤。
来源 2 也因与触发器的范围不一致而被滤除。此来源也与触发器具有相同的过滤条件，但系统会在归因后再应用高级过滤条件。

归因期间

系统不会选择来源 3 进行归因，因为其优先级低于来源 4。
系统选择了来源 4，因为它与触发器具有匹配的归因范围，并且优先级最高。高级过滤器会在归因后应用，因此在归因过程中不会被纳入考量范围。

帖子归因

由于所选来源（来源 4）的高级过滤条件与触发器不重叠，因此系统不会生成任何报告。

上述示例不会生成报告。但是，如果完全移除第四个来源，则：

同一张图片，其中有 4 个标记为来源的框，编号为 1 到 4，还有一个标记为

归因期间

系统选择了来源 3，因为该来源与触发器具有重叠的归因范围。

帖子归因

来源 3 不会被拒绝，因为其过滤条件与触发器中的过滤条件相交。然后，归因将接受归因后的其余检查，如果通过所有检查，系统会生成报告。

归因范围可减少要考虑用于归因的来源数量。然后，系统会将剩余的归因步骤应用于这个较小的来源池，这可能会生成报告。

归因范围在归因流程中的位置

在选择要用于归因的来源之前，系统会应用归因范围。这也优先于顶级过滤条件和自定义报告期过滤条件。下图显示了整个归因流程的简化版本，其中归因范围在归因和其余归因检查之前。

归因流程操作

以下是归因流程中执行的各种操作的总结：

来源注册：当用户与广告客户网站上的广告互动时，系统会注册来源事件。然后，设备会向报告来源的端点发送请求，该端点会以包含来源事件数据的标头做出响应。
触发器注册：当广告客户网站上发生转化时，系统会注册触发器事件。设备会向报告来源发送另一个请求，报告来源会以包含触发器事件数据的标头进行响应。
来源匹配：设备会根据目标网站、报告来源和到期时间等条件匹配来源和触发器事件。
归因范围检查：系统会根据来源和触发器 attribution_scopes 值之间的交集来过滤来源。
归因：如果存在多个匹配来源，设备会选择优先级最高的来源进行归因。如果优先级相同，则系统会选择最新的优先级。
过滤条件检查：设备会比较来源过滤条件和触发器过滤条件，以确定它们是否匹配。如果过滤条件不匹配，则会舍弃归因。
停用其他来源：如果所选来源的过滤条件匹配，设备会停用在来源匹配阶段匹配的来源。已停用的来源包括归因范围与触发器范围不匹配的来源。
归因后检查：设备会对所选归因执行更多检查，例如检查来源是否因虚假报告而产生噪声、使用去重键检查重复归因、检查触发器是否在来源的报告时间范围内，以及检查速率限制。
生成报告：如果所有检查均通过，设备会生成归因报告并安排将其发送到报告来源的端点。

后续步骤

如需详细了解归因范围，请参阅 GitHub 上的“归因前过滤”说明。
如需详细了解过滤条件，请参阅使用过滤条件定义客户规则。

使用归因范围在归因之前过滤来源 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

在来源注册期间

来源注册示例

在触发器注册期间

触发器注册示例

归因范围示例

来源注册 1

来源注册 2

触发器注册

归因范围与过滤条件

归因前

归因期间

帖子归因

归因期间

帖子归因

归因范围在归因流程中的位置

归因流程操作

后续步骤

使用归因范围在归因之前过滤来源
使用集合让一切井井有条根据您的偏好保存内容并对其进行分类。