关于调试归因报告的 3 部分内容中的第 1 部分。了解调试的重要性以及何时在测试中使用调试报告。
为什么需要调试报告
如果您正在测试 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 部分：调试实用指南。
使用可汇总的报告进行本地测试
与加密的可汇总归因报告不同，可汇总调试报告包含未加密的载荷。
使用可汇总的调试报告来验证可汇总报告的内容，并使用本地汇总工具生成摘要报告以进行测试。
重新处理 Aggregation Service 报告
使用调试模式的另一个好处是，您可以重新处理报告。因此，如需多次处理报告，请务必启用调试报告。 在以下情况下，您可能需要重新处理报告：
- 尝试调试 Aggregation Service。
- 尝试不同的批处理策略。
- 尝试不同的 epsilon 值。
数据恢复
我们建议广告技术平台启用调试模式以接收调试报告，以便恢复报告数据。这在出现汇总服务问题（例如服务不可用或无响应）时非常有用，这些问题可能会导致摘要报告生成失败。