此页面由 Cloud Translation API 翻译。

归因报告使用入门

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

选择报告类型

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

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

事件级报告

Event-level reports associate a particular ad click or view (on the ad side) with data on the conversion side. To preserve user privacy by limiting the joining of user identity across sites, conversion-side data is very limited, and the data is noisy.

摘要报告

A summary report is an Attribution Reporting API and Private Aggregation API report type. A summary report includes aggregated user data and can contain detailed conversion data, with noise added. Summary reports are made up of aggregate reports.

实现

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

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

生成事件级报告

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

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

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

生成摘要报告

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

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

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

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

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

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

可选步骤

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

不要忘记功能检测

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

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

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

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