有关调试 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 跟踪的转化都会生成归因报告。
例如：对于事件级报告，每次展示最多只能记录一次转化。这意味着，对于某次广告展示，无论用户发生了多少次转化，您都只会获得一份归因报告。
使用调试报告可以深入了解基于 Cookie 的衡量结果与通过 Attribution Reporting API 获得的结果之间的差异。明确哪些转化会报告，有多少转化没有报告，并具体分析哪些转化及相关原因。
如需了解如何运行损失分析，请参阅第 3 部分：调试实战宝典。
问题排查
虽然隐私或资源保护导致的损失是正常的，但其他损失也可能是意料之外的。实现方式配置错误或浏览器本身出现错误可能会导致报告缺失。
您可以使用调试报告检测并修复您一方的实现问题，或向浏览器团队报告潜在 bug。如需了解如何执行此操作，请参阅第 3 部分：调试实战宝典。
高级配置检查
您可以使用 Attribution Reporting API 的某些功能自定义 API 的行为。例如，过滤规则、重复信息删除规则和优先级规则。
使用这些功能时，您可以使用调试报告检查您的逻辑能否在生产环境中实现预期行为，而无需等待归因报告。如需了解如何执行此操作，请参阅第 3 部分：调试实战宝典。
使用可汇总的报告进行本地测试
与加密的可汇总归因报告不同，可汇总的调试报告包含未加密的载荷。
使用可汇总的调试报告来验证可汇总报告的内容，并使用本地汇总工具生成摘要报告以进行测试。
重新处理汇总服务报告
使用调试模式的另一个优势是，您可以再次处理报告。因此，如果要多次处理报告，请务必启用调试报告。 在以下情况下，您可能需要重新处理报告：
- 尝试调试汇总服务。
- 尝试不同的批处理策略。
- 尝试不同的 Epsilon 值。
数据恢复
我们建议广告技术平台启用调试模式来接收调试报告，以便恢复其报告数据。如果出现汇总服务问题（例如可能导致摘要报告生成失败的不可用或无响应服务），这会非常有用。