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

配置 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 次），浏览器将执行以下操作：

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

  • 请改为删除优先级最低的报告，然后安排生成新报告。如果新报告的优先级最低，系统会忽略该报告，您也不会收到该报告。

如果未设置优先级，浏览器会回退到默认行为：对于点击型转化，系统会舍弃在第三次转化之后发生的所有转化；对于浏览型转化，系统会舍弃在首次转化之后发生的所有转化。

查看示例代码：优先处理类型为“结账”的转化

后续步骤

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