此页面由 Cloud Translation API 翻译。

归因报告使用入门

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

选择报告类型

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

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

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

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

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

请注意，对于给定的事件来源，您可以同时生成事件级报告和可汇总报告。演示将引导您完成整个过程。

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

注册来源。如需查看相关说明，请参阅注册归因来源。请注意，点击次数和观看次数的步骤有所不同。
注册触发器。如需查看相关说明，请参阅注册归因触发器。
使用以下网址设置端点：
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution。
如需了解 POST 方法，请参阅 adtech.js 中的示例代码；如需详细了解 .well-known，请参阅维基百科。

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

要生成摘要报告，请按以下简要步骤操作：

注册来源。如需查看相关说明，请参阅注册归因来源。请注意，点击次数和观看次数的步骤有所不同。如需了解更多详情，请参阅归因来源注册。
注册触发器。如需查看相关说明，请参阅注册归因触发器。
使用以下网址为可汇总报告设置端点：
{REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution。
如需了解 POST 方法，请参阅 adtech.js 中的示例代码；如需详细了解 .well-known，请参阅维基百科。
批量发送并发送报告，以便汇总服务进一步处理，从而生成摘要报告。请参阅批量可汇总报告。

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

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

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

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

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

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

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