关于调试归因报告的第 3 部分（共 3 部分）。查找有关如何使用调试报告的说明。
在此实用指南中，您将找到有关如何使用调试报告的说明，这些说明适用于第 1 部分：调试报告简介中概述的各种使用情形。
术语库
- 报告来源是用于设置归因报告来源和触发器标头的来源。浏览器生成的所有报告都会发送到此源。在本指南中，我们使用
https://adtech.example作为示例报告来源。 - 归因报告（简称“报告”）是包含您请求的衡量数据的最终报告（事件级报告或可汇总报告）。
- 调试报告包含有关归因报告或者来源或触发器事件的其他数据。收到调试报告并不一定表示存在问题！调试报告有两种
- 过渡调试报告是一种调试报告，需要设置 Cookie 才能生成和发送。如果 Cookie 未设置且第三方 Cookie 被弃用，过渡调试报告将不可用。本指南中描述的所有调试报告都是过渡性调试报告。
- 成功调试报告用于跟踪成功生成归因报告。它们与归因报告直接相关。从 Chrome 101（2022 年 4 月）开始，已提供成功调试报告。
- 详细调试报告可以跟踪缺失的报告，并帮助您确定缺失报告的原因。它们分别用于表明浏览器未记录来源或触发器事件（这意味着浏览器不会生成归因报告）以及由于某种原因无法生成或发送归因报告的情况。详细调试报告包含一个
type字段，用于说明未生成来源事件、触发器事件或归因报告的原因。从 Chrome 109（2023 年 1 月稳定版）开始提供详细调试报告。 - 调试键是您可以在来源端和触发器端设置的唯一标识符。通过调试键，您可以映射基于 Cookie 的转化和基于归因的转化。将系统设置为生成调试报告并设置调试密钥后，浏览器会将这些调试密钥添加到所有归因报告和调试报告中。
如需了解我们的文档中使用的更多概念和关键术语，请参阅 Privacy Sandbox 术语表。
操作指南：实时检查集成
- 设置系统以生成成功调试报告。如需了解具体操作方法，请参阅第 2 部分：设置调试报告。
- 每次部署归因报告代码时，请实时检查您是否在端点上收到一些成功调试报告。如果显示了这些信息，则表示您的 Attribution Reporting 设置正常运行。
- 只有在发生转化时，才会发送成功调试报告。相反，您可能需要检查集成是否已正确设置（无论是否发生转化），也就是说，您需要检查来源是否已成功注册。为此，您可以依赖来源注册成功 详细调试报告。如需了解如何在第 2 部分：设置调试报告中设置这些报告，请参阅该部分。
操作指南：分析损失并排查集成问题
若要将基于 Cookie 的转化衡量结果与 Attribution Reporting 报告进行比较，请使用调试密钥，并将 Cookie 转化与调试报告相关联。请注意，调试报告会立即发送到您的端点。
概览
使用调试键（<source_debug_key, trigger_debug_key> 对）将 Cookie 转化映射到成功调试报告。
对于每次 Cookie 转化，您是否在转化时收到了相应的成功调试报告？
如果为“是”：对于所有这些成功调试报告，您都可以期待稍后收到归因报告，但有少数例外情况。如需了解详情，请查看成功调试报告方案。
如果不是：这意味着转化未在 Attribution Reporting 中注册。使用 <source_debug_key, trigger_debug_key> 对（如果缺少触发调试键，则使用来源调试键）将 Cookie 转化映射到详细的调试报告。对于每项转化，您是否在某个时间点（来源时间或触发时间）收到了相应的详细调试报告？
如果您未收到详细的调试报告，可能是因为用户行为或集成问题。如需了解详情，请参阅无调试报告情景。
如果您确实收到了详细的调试报告，请查看其
type字段。如果其
type为source-success：这表示来源已成功注册，但触发器未成功注册。如需缩小成功调试报告缺失的原因，请查找任何其他类型的相应详细调试报告，该报告将指示触发器方面存在问题。如果其
type是其他任何值：表示来源或触发器尚未注册。type会告诉您原因。相应的归因报告（以及成功调试报告）将丢失。根据详细调试报告的type，您可能只想将此信息视为损失分析数据点（换句话说，您无需采取任何行动），也可能想要提交 bug 或排查实现方面的问题。如需了解详情，请参阅详细调试报告方案。
可能的情形
成功调试报告
如果针对给定的 Cookie 转化，您收到了成功调试报告，则表示此转化已成功注册到 Attribution Reporting。
您之后会收到相应转化的归因报告，但有以下几种例外情况：
- 用户行为：在转化后和归因报告发送之前清除数据、关闭浏览器等。如果用户在转化后关闭浏览器，并且在一周内未打开浏览器，则报告将在一周或更长时间内不会发送。您可能会将此延迟视为损失。
- 仅适用于事件级报告：事件级报告被另一个优先级更高的报告取代。
- 可能存在的网络问题。
类型为 source-success 的详细调试报告
如果针对给定 Cookie 转化的来源，您收到了类型为 source-success 的详细调试报告，则表示来源注册成功。根据触发器注册是否在稍后也成功，您可能会收到或不会收到相应转化的报告。
不过，需要注意以下一点：
任何其他类型的详细调试报告
如果针对给定的 Cookie 转化，您收到了任何其他类型的详细调试报告，则不会收到成功调试报告，因此之后也不会收到归因报告，因为详细报告意味着发生了可报告的失败。某些因素导致来源注册、触发注册、报告生成或报告发送失败。可能的原因：
- 隐私权限制
- 存储空间上限
- 自定义规则
- 代码中的实现问题
- 浏览器 bug
其中一些是预期情况！具体采取哪种操作取决于每个详细报告的 type。查看详细报告参考文档。
无调试报告
如果针对给定的 Cookie 转化，您仅收到了归因报告（没有成功调试报告，也没有详细调试报告），则表示有某种原因阻止了调试报告的生成。可能的原因：
- 用户偏好设置（用户已关闭第三方 Cookie）
- 缺少 Cookie，或缺少调试密钥（由于缺少 Cookie 而清除了调试密钥）。在
chrome://attribution-internals中，打开日志标签页，查看其中是否显示任何问题。 - 在来源时间或触发时间发生，但在发送归因报告时未发生的网络问题。
您是否收到了归因报告？
这是未收到调试报告的一种子情况：如果对于给定的 Cookie 转化，您未收到任何类型的报告（任何类型的调试报告、归因报告），则表示发生了无法报告的故障。可能的原因：
- 基本集成问题。如需了解如何排查这些问题，请参阅修正基本集成问题。
- 可能存在的网络问题。
- 浏览器设置中的用户偏好设置，例如 Privacy Sandbox 已关闭。
详细调试报告参考文档
每个详细调试报告都有一个 type 字段，用于捕获相应归因报告被舍弃的原因。使用此参考信息来确定，对于详细报告的每个 type，应采取什么操作。
来源注册成功
来源已成功注册。
source-success- 详细信息和报告正文
隐私保护限制报告
这些报告是预期之中的。它们表示隐私限制，旨在减少跨网站的用户身份泄露。
source-destination-limit- 详细信息和报告正文
source-noised- 详细信息和报告正文
trigger-attributions-per-source-destination-limit- 详细信息和报告正文
trigger-reporting-origin-limit- 详细信息和报告正文
trigger-event-noise- 详细信息和报告正文
trigger-event-excessive-reports- 如果报告数量超出限制，系统会生成此错误；对于每次展示，您最多可以注册一次转化；对于每次点击，您最多可以注册三次转化。请注意，您可以设置优先级，以配置要接收哪些报告。详细信息和报告正文
存储空间限制报告
这些报告是预期之中的。它们用于指示存储空间限制，以防止过度使用资源。
source-storage-limit- 详细信息和报告正文
trigger-event-storage-limit- 详细信息和报告正文
trigger-aggregate-storage-limit- 详细信息和报告正文
自定义规则报告
如果您使用过滤、去重、优先级或基于窗口的过滤，则可能会出现这些报告。为保险起见，请仔细检查相应的自定义规则，确认与该详细报告对应的报告确实是您想要舍弃的报告。如果此信息正确无误，您无需采取任何行动。
trigger-no-matching-filter-data- 详细信息和报告正文
trigger-event-no-matching-configuration- 详细信息和报告正文
trigger-event-deduplicated- 详细信息和报告正文
trigger-aggregate-deduplicated- 详细信息和报告正文
trigger-event-low-priority- 详细信息和报告正文
trigger-event-report-window-passed- 详细信息和报告正文
trigger-aggregate-report-window-passed- 详细信息和报告正文
其他详细报告
这些报告可能表明您的代码中存在潜在的实现问题。
trigger-no-matching-source- 这可能是实现问题。检查
<reporting origin, destination>的设置中是否存在配置错误。这可能也是预期的 API 行为。例如，用户在与广告互动后但在转化前清空了数据，或者用户在从未看到相关联的广告的情况下完成了转化。 详细信息和报告正文 trigger-aggregate-no-contributions- 这可能不是您希望代码具有的行为。排查触发注册代码方面的问题；确保贡献配置正确无误。 详细信息和报告正文
trigger-aggregate-insufficient-budget- 这可能不是您希望代码具有的行为。仔细检查您的触发注册代码，确保所有贡献的总和不超过贡献预算。 详细信息和报告正文
意外错误（可能存在浏览器 bug）
这些报告出乎意料。这可能是浏览器 bug 导致的！提交 bug，并在说明中指定重现步骤。
流失分析示例
第 1 步：设置和 Cookie 映射
按照第 2 部分：设置调试报告中的说明设置系统，以生成成功调试报告和详细调试报告。
这样一来，您就可以使用基于 Cookie 的转化信息来查找相应的调试报告或归因报告。
第 2 步：确定成功注册的商品和缺失的报告
在此示例中，我们假设您已通过基于 Cookie 的系统跟踪了 100 次转化。
每次记录基于 Cookie 的转化时，请查找与该基于 Cookie 的转化具有相同 <source_debug_key, trigger_debug_key> 对的成功调试报告（立即发送）。
假设您已收到其中 70 次 Cookie 转化成功的调试报告。
- 成功报告表示归因已成功记录，因此您可以放心地假设，您将获得与每个成功报告对应的归因报告，但也有一些例外情况。
- 您可以决定是否监控这些异常。为此，在接下来的几天或几周内（具体取决于过期时间），当归因报告发送到您的端点时，请查找与每个成功调试报告具有相同调试键对的归因报告。请务必稍等片刻：报告可能不会在每个时间段结束时立即发送。假设您只找到了 60 份归因报告。缺少 10 份归因报告可能是因为用户行为。
第 3 步：简短的损失评估
100-70 = 30 个归因成功调试报告缺失。这意味着，在基于 Cookie 的实现中跟踪到的这 30 次转化未通过归因报告记录。您将不会收到这些广告系列的归因报告。
由于您有 100 次基于 Cookie 的转化，但只有 70 次基于归因的转化，因此您的损失为 30%。现在，您有了一份简短的损失评估报告。
第 4 步：分析原因
如需调查为何缺少这些报告，请查找您在转化（触发器注册）时或更早的来源注册时收到的相应详细调试报告。使用基于 Cookie 的转化的键将这些键映射到详细的调试报告。
- 假设有 10 个密钥没有详细的调试报告。检查是否存在任何集成问题。如果不是，则可能是用户行为所致。
- 您有 20 份详细调试报告。您现在可以优化损失分析。分析每个详细报告的
type字段。例如，您可能会发现：- 由于
pending destination limit，有 10 份报告（即示例中的 10%）缺失 - 由于
trigger-aggregate-no-contributions，有 5 个（占 5%）报告缺失。 - 由于
unknown-error，有 5 个（占 5%）报告缺失。
- 由于
第 5 步：采取行动并进行问题排查
现在，您已经了解了报告缺失的原因，可以根据这些数据洞见采取行动了。
具体采取哪种操作取决于每个详细报告的 type。如需了解详情，请参阅详细报告参考文档。例如：
pending-destination-limit是一项隐私保护功能。您无需执行任何操作。您可以将此数字作为数据点，以便自行查看和监控。trigger-aggregate-no-contributions可能表示您的实现存在问题。进一步分析。如果需要，请使用详细报告正文中的详细信息来排查和修复此问题。unknown-error可能表示存在浏览器 bug 或网络错误。如果您反复遇到此问题，请向浏览器开发者提交 bug 报告。