关于调试 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 都可能会导致报告缺失。
您可以使用调试报告检测并修复您端的实现问题，或向浏览器团队报告潜在 bug。如需了解如何执行此操作，请参阅第 3 部分：调试实战宝典。
高级配置检查
Attribution Reporting API 的某些功能允许您自定义 API 的行为。例如过滤规则、重复信息删除规则和优先级规则。
使用这些功能时，使用调试报告检查您的逻辑是否会导致生产环境中的预期行为，而无需等待归因报告。如需了解如何执行此操作，请参阅第 3 部分：调试实战宝典。
使用可汇总报告进行本地测试
与已加密的可汇总归因报告不同，可汇总的调试报告包含未加密的载荷。
使用可汇总的调试报告来验证可汇总报告的内容，并使用本地汇总工具生成摘要报告以进行测试。
重新处理汇总服务报告
使用调试模式的另一个优势是，可让您再次处理报告。因此，要多次处理报告，请务必启用调试报告。 在以下情况下，您可能需要重新处理报告：
- 尝试调试汇总服务。
- 使用不同的批处理策略进行实验。
- 使用不同的 epsilon 值进行实验。
数据恢复
我们建议广告技术平台启用调试模式以接收调试报告，以便恢复报告数据。在汇总服务问题（例如，服务不可用或无响应）时，可能导致摘要报告生成失败，这会非常有用。