此页面由 Cloud Translation API 翻译。

归因报告使用入门

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

选择报告类型

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

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

事件级报告

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

摘要报告

摘要报告是一种 Attribution Reporting API 和 Private Aggregation API 报告类型。摘要报告包含汇总的用户数据，并且可能包含添加了噪声的详细转化数据。摘要报告由汇总报告组成。与事件级报告相比，摘要报告具有更大的灵活性和数据模型，尤其是对于某些应用场景（例如转化价值）。

实现

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

请注意，对于指定的事件来源，可以同时生成事件级报告和可汇总报告。通过 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 无法使用。为了保护用户隐私，您无法以编程方式进行检查。