归因报告使用入门

下面介绍了如何开始设置,包括设置和快速概览。

选择报告类型

您可以使用 Attribution Reporting API 生成两种类型的报告:事件级报告和摘要报告。与可汇总报告或摘要报告相比,事件级报告所需的设置更少,因此报告可能是不错的着手点。摘要报告需要与汇总服务集成;事件级报告则不然。

您可以为事件级报告和摘要设置报告。二者互为补充。

事件级报告

事件级报告:将(广告端)的特定广告点击或观看与转化端数据相关联。为了通过限制跨网站联接用户身份来保护用户隐私,转化端数据非常有限,并且数据非常嘈杂。

摘要报告

摘要报告分为 Attribution Reporting API 和 Private Aggregation API 两种报告类型。摘要报告包含汇总的用户数据,可以包含详细的转化数据,但添加了噪声。摘要报告由汇总报告组成。

实现

您可以尝试按以下步骤进行操作。

请注意,对于指定的事件来源,可以同时生成 事件级报告和可汇总报告。通过 demo 可以引导您完成整个流程。

生成事件级报告

以下是生成事件级报告所需遵循的最少步骤:

  1. 注册来源。如需查看相关说明,请参阅注册归因来源。请注意,点击次数和观看次数的步骤有所不同。

  2. 注册触发器。如需查看相关说明,请参阅注册归因触发器

  3. 使用以下网址设置端点
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
    请参阅 adtech.js 中的示例代码,了解 POST 方法;如需详细了解 .well-known,请参阅 Wikipedia

如需了解详情,请参阅事件级报告说明文档

生成摘要报告

要生成摘要报告,请按以下简要步骤操作:

  1. 注册来源。如需查看相关说明,请参阅注册归因来源。请注意,点击次数和观看次数的步骤有所不同。如需了解更多详情,请参阅归因来源注册

  2. 注册触发器。如需查看相关说明,请参阅注册归因触发器

  3. 使用以下网址为可汇总报告设置端点
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
    请参阅 adtech.js 中的示例代码,了解 POST 方法;如需详细了解 .well-known,请参阅 Wikipedia

  4. 批量发送并发送报告,以便汇总服务进一步处理,从而生成摘要报告。请参阅批量可汇总报告

如需了解详情,请参阅可汇总报告说明

请参阅归因报告调试系列,了解如何设置调试报告。

“摘要”报告中的其他概念

除了了解此处的实施步骤外,以下概念也有助于您规划摘要报告策略:

可选步骤

  1. 设置过滤条件(可选): <ph type="x-smartling-placeholder">
      </ph>
    1. 请按照 使用过滤条件定义自定义规则
    2. 如需查看可汇总报告的过滤条件的专属详情,请前往 触发器部分 explainer

不要忘记功能检测

使用该 API 之前,请使用权限政策检测该 API 是否未在网页上被屏蔽。 为此,请运行以下代码:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

如果此功能检测检查返回 true,则允许在运行检查的上下文(页面)中使用该 API。

请注意,仅执行此项检查并不能保证 API 可在该网页上使用;用户可能是通过其浏览器设置停用了 API,或者可能是其他设置导致 API 无法使用。为了保护用户隐私,您无法以编程方式进行检查。

后续步骤

如果您已准备好开始实施,请查看以下文档:

设置

背景

演示和工具

规划

如果您仍处于规划阶段,请参阅以下文档: