优先考虑特定点击、观看或转化

配置 API 以对特定来源或触发器进行优先级排序。

在事件级报告或可汇总报告中优先显示特定点击或浏览

您可以使用来源端优先级更改 Attribution Reporting API 的默认行为。默认情况下，归因模型为“最终接触”，也就是说，转化会归因于最近一次匹配的来源事件。对于事件级报告和可汇总报告，您都可以调整此行为。

如需更改默认优先级，请将 priority 键添加到来源注册标头。

为您希望优先处理的来源设置较高的优先级。值越大表示优先级越高；例如，priority 为 2 的来源事件优先于 priority 为 1 的来源事件。

系统仅发送与具有最高优先级的来源事件匹配的报告。

示例代码

更改归因，以选择时间较短的来源（首次点击）：

const currentTimestamp = Date.now();
const priority = -currentTimestamp;

res.set(
  "Attribution-Reporting-Register-Source",
  JSON.stringify({
    // … all usual fields for that header
    priority: `${priority}`
  })
);

在事件级报告中优先促成特定转化

与来源端优先级不同，设置触发器端优先级仅适用于事件级报告。

假设用户点击了广告并完成了四次转化：他们访问广告客户的网站首页，访问产品页，注册简报，最后进行购买。

但是，由于针对点击次数的报告有三次限制，因此默认情况下，注册后的所有后续报告（第三次转化）都会被舍弃，包括购买报告。

不过，您可以配置 API，以便接收您认为更重要的转化报告（例如购买报告）。

为此，请将 priority 键添加到您的触发器注册标头，并为要优先处理的转化设置较高的优先级。

当针对特定来源事件触发归因时，如果已达到此来源的归因数量上限（3 项用于点击次数，1 项用于查看），浏览器将：

  • 将新报告的优先级与同一来源的现有定期报告的优先级进行比较。

  • 请删除优先级最低的报告，以改为定期生成新报告。如果新报告是优先级最低的报告，则会被忽略且您不会收到该报告。

如果未设置优先级，浏览器将恢复到默认行为：第三次点击转化或观看首次转化后发生的所有转化都会被丢弃。

查看示例代码：优先考虑结账类型的转化

后续步骤

如需了解如何设置来源和触发器，请参阅：