配置 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 次),浏览器将:
将新报告的优先级与同一来源的现有已安排报告的优先级进行比较。
删除优先级最低的报告,以便安排生成新报告。如果新报告的优先级最低,系统会忽略该报告,您也不会收到该报告。
如果未设置优先级,浏览器会回退到其默认行为:对于点击,任何发生在第三次转化之后的转化都会被舍弃;对于浏览,任何发生在第一次转化之后的转化都会被舍弃。
查看示例代码:优先考虑结账类型的转化
后续步骤
如需了解如何设置来源和触发器,请参阅: