此页面由 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
请参阅 adtech.js 中的示例代码，了解 post 方法。如需详细了解 .well-known，请点击此处。
批量发送和发送报告，以供汇总服务生成摘要报告做进一步处理。请参阅批量生成的可汇总报告。

如需详细了解摘要报告，请访问此处。

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

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

设置过滤条件（可选）：
1. 按照使用过滤条件定义自定义规则中的说明操作。
2. 如需查看有关可汇总报告的过滤条件的详细信息，请参阅说明的“触发器”部分。

使用该 API 之前，请先使用 Permissions-Policy 检测该 API 是否在该页面上被屏蔽。为此，请运行以下代码：

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

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

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