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

配置 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}`
  })
);

为事件级报告确定特定转化的优先级

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

假设用户点击了一则广告并完成了四次转化:他们访问了广告客户的网站首页,然后访问了某个产品页面,订阅了简报,最后完成了购买。

但由于点击次数的报告限制为 3 次,因此默认情况下,注册(第三次转化)之后的所有后续报告(包括购买报告)都会被舍弃。

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

为此,请将 priority 键添加到触发注册标头,并为要优先考虑的转化设置更高的优先级。

当针对指定来源事件触发归因时,如果该来源的归因次数已达到上限(点击为 3 次,观看为 1 次),浏览器将:

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

  • 删除优先级最低的报告,以便安排生成新报告。如果新报告的优先级最低,系统会忽略该报告,您也不会收到该报告。

如果未设置优先级,浏览器会回退到其默认行为:对于点击,任何发生在第三次转化之后的转化都会被舍弃;对于浏览,任何发生在第一次转化之后的转化都会被舍弃。

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

后续步骤

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