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