有关调试 Attribution Reporting 的第 1 部分（共 3 部分）。了解调试的重要性以及何时在测试中使用调试报告。
为什么需要调试报告
如果您要测试 Attribution Reporting API， 您应检查集成是否正常运行，了解 基于 Cookie 的实现和 Attribution Reporting 实现，并排查集成过程中出现的所有问题。
您必须提供调试报告才能完成这些任务。因此，我们强烈建议您进行设置。
术语库
调试报告的主要方面
两种类型的调试报告
我们提供了两种调试报告。您可以同时使用这两者，因为它们的使用场景不同。
成功调试报告
成功调试报告用于跟踪成功生成归因报告。它们与 直接添加到归因报告
自 Chrome 101（2022 年 4 月）起，已提供成功调试报告。
详细调试报告
详细调试报告可让您更清楚地了解来源和触发器事件，因此您可以确保已成功注册来源；也可以跟踪缺失的报告，并确定缺失报告的原因（来源或触发器事件失败、发送或生成报告失败）。 详细调试报告会指出：
- 浏览器成功注册来源的情况。
- 浏览器未成功注册来源或触发器事件的情况，这意味着浏览器不会生成归因报告。
- 由于某种原因无法生成或发送归因报告的情况。
详细调试报告包含一个 type 字段，用于说明来源注册成功或来源、触发器或归因报告未生成的原因。
自 Chrome 109（2023 年 1 月）起，我们已提供详细调试报告，但 Chrome 112 后续将新增来源注册成功详细调试报告除外。
查看第 2 部分：设置调试报告中的示例报告。
调试报告基于 Cookie
如果配置为接收报告的来源是第三方，则此 Cookie 就是第三方 Cookie。这有几个关键的含义：
- 只有在使用第三方 Cookie 的情况下， 用户浏览器允许的上限。
- 待第三方 Cookie 停用后，您将无法再获取调试报告 被淘汰。
立即发送调试报告
浏览器会立即将调试报告发送到报告来源。这个 与归因报告不同，归因报告会以 延迟。
成功调试报告生成后， 系统会生成相应的归因报告：即在触发 注册。
在来源或触发时立即发送详细调试报告 注册。
调试报告具有不同的端点路径
与归因报告一样，所有调试报告都会发送到报告来源。调试报告会发送到报告来源的三个独立端点：
- 用于事件级成功调试报告的端点
- 用于“成功”调试报告的端点，可汇总
- 详细调试报告的端点，可汇总事件级报告。
如需了解详情，请参阅第 2 部分：设置调试报告。
使用场景
基本的实时集成检查
与归因报告不同，调试报告会立即发送到您的端点 以保护用户隐私为目标将调试报告用作实时信号，表明您与 Attribution Reporting API 正常运行。
如需了解如何执行此操作，请参阅第 3 部分：调试实战宝典。
损失分析
与第三方 Cookie 不同，Attribution Reporting API 提供内置的隐私保护机制 的保护，旨在平衡实用性 和隐私权。这意味着，借助 Attribution Reporting API，您可能无法 能够收集您当前通过 Cookie。并非您能够获得的所有转化 系统将会生成归因报告。
例如：对于事件级报告，您最多只能记录一次转化 每次展示这意味着，对于某次广告展示，无论用户发生了多少次转化，您都只会获得一份归因报告。
使用调试报告可深入了解 基于 Cookie 的衡量结果，以及通过归因工具获得的成效 Reporting API。明确报告了哪些转化、有多少转化 具体有哪些问题以及原因是什么
如需了解如何运行损失分析，请参阅第 3 部分：调试实战宝典。
问题排查
虽然隐私或资源保护措施会造成的损失是正常的，但是其他损失是正常的， 可能是意外产生的。您的实现中存在错误配置或 可能会导致报告缺失。
您可以使用调试报告检测并解决您一方的实现问题，或 向浏览器团队报告潜在错误要了解如何执行上述操作，请参阅 第 3 部分：调试实战宝典。
高级配置检查
利用 Attribution Reporting API 的某些功能，您可以自定义该 API 的 行为例如，过滤规则、重复信息删除规则和优先级规则。
使用这些功能时，请使用调试报告检查您的逻辑能否在 无需等待归因报告。如需了解如何执行此操作，请参阅第 3 部分：调试实战宝典。
使用可汇总的报告进行本地测试
与加密的可汇总归因报告不同，可汇总调试报告 包含未加密的载荷
使用可汇总的调试报告来验证可汇总报告的内容， 以及使用本地汇总工具生成摘要报告以进行测试。
重新处理汇总服务报告
使用调试模式的另一个优势是，您可以再次处理报告。因此，如果要多次处理报告，请务必启用调试报告。 在以下情况下，您可能需要重新处理报告：
- 尝试调试汇总服务。
- 尝试不同的批处理策略。
- 尝试不同的 Epsilon 值。
数据恢复
我们建议广告技术平台启用调试模式来接收调试报告，以便恢复其报告数据。如果出现汇总服务问题（例如可能导致摘要报告生成失败的不可用或无响应服务），这会非常有用。