使用代码诊断工具排查代码问题

您可以使用代码诊断工具查找并修复网站代码存在的问题，确保数据收集准确无误。通过 Google Ads 和 Google Analytics 的“Google 代码”部分，以及通过 Google 跟踪代码管理器，都可以访问代码诊断工具。

本页内容

• 打开代码诊断工具
• 代码质量状态
• 诊断

---

打开代码诊断工具

1. 打开 Google 代码设置。
2. 在“您的 Google 代码”下的“代码质量”部分，选择查看诊断信息。

---

代码质量状态

代码诊断工具会显示以下代码质量状态，以标明在 Google 代码中检测到的问题、问题的严重程度以及修复方式。问题得到修复后，其状态会更新，以反映改进后的代码质量。

极佳

“极佳”表示未检测到 Google 代码存在任何问题。如果显示此数据质量状态，就说明代码已全面优化，因此您不会遇到任何问题。不过，请务必继续留意代码质量状态，因为在检测到新问题时，状态可能会发生变化。

良好

“良好”表示未检测到 Google 代码存在任何问题，但我们提供了至少一项建议来帮助您提高代码质量。

需要注意

“需要注意”表示 Google 代码存在需要您注意的问题。应修复相应问题，但问题并不严重。

紧急

“紧急”状态表示 Google 代码存在严重问题，需要立即解决，才能确保效果衡量的准确性。例如，如果系统之前曾检测到 Google 代码，但在过去 48 小时内却未检测到，导致数据降为零，就会触发“紧急”状态。如需解决“紧急”状态，请检查您的设置，确保已正确植入 Google 代码。

无最近的数据

“无最近的数据”表示从未在您的网站上检测到 Google 代码。

---

诊断

我们可能会向您显示以下一项或多项诊断信息，帮助您识别代码植入设置存在的问题：

• 检测到只有一位管理员：当您的账号只有一位管理员时，系统就会显示此诊断信息。如果该唯一管理员无法操作账号，您可能就会失去对代码的访问权限。如需解决此问题，请为您的账号再添加至少一位管理员。
• 检测到其他需要配置的网域：如果我们检测到您尚未在 Google 代码设置中指定的一个或多个其他网域，系统就会显示此诊断信息。如需解决此问题，请指定使用 Google 代码的所有网域。
• config 命令顺序错误：如果 gtag event 命令在 gtag config 命令之前发送，系统就会显示此诊断信息。此问题可能会导致在转送和处理这些事件时出现意外行为。如需解决此问题，请验证每个网页上的代码是否正确地将 config 命令放置在任何 event 命令之前。
• 缺少转化链接器：如果您有 Floodlight 和/或 Google Ads 代码，但尚未向 Google 跟踪代码管理器容器添加转化链接器代码，系统就会显示此诊断信息。如需解决此问题，请向容器添加转化链接器代码。
• 使用的是旧版 Universal Analytics 代码：如果您的部分网页使用 Universal Analytics 代码来加载 GA4 代码或其他代码，以便使用已关联的网站代码发送数据，系统就会显示此诊断信息。这可能会导致您无法使用某些 Google 代码功能，例如增强型衡量。我们建议您利用全套 Google 代码并部署到您的网页上，或使用 Google 跟踪代码管理器。
• 部分网页未征求 EEA 用户的意见：如果在欧洲经济区 (EEA) 境内通过 Google 代码发送的数据在您网站的部分网页上未标有用户同意情况，并且我们无法确定您是否已在这些网页上屏蔽代码，系统就会显示此诊断信息。如需解决此问题，请验证数据是否已标有用户同意情况。
• 网站/应用未就广告个性化提供 EEA 用户意见征求数据：如果在欧洲经济区 (EEA) 境内通过 Google 代码发送的数据未标有用户关于广告个性化的同意情况，系统就会显示此诊断信息。您要么已实现意见征求模式 v1 且已进行自动委托（ad_user_data 从 ad_storage 读取），要么已实现意见征求模式 v2 但尚未实现广告个性化意见征求。如需解决此问题，请升级到意见征求模式 v2。
• 意见征求模式安装顺序错误：如果您的部分网页以错误的顺序加载意见征求模式命令，系统就会显示此诊断信息；此问题可能会导致同意情况信号不准确。如需解决此问题，请验证您是否已按正确的顺序放置意见征求模式命令。
• 检测到的同意率为 0%，请验证意见征求模式设置：如果系统检测到您无论地理位置如何设置，都始终发送 ad_user_data 拒绝信号，就会显示此诊断信息，因为这会导致同意率为 0%。如需解决此问题，请排查意见征求设置问题。
• 检测到部分地区的同意率为 0%：如果我们检测到您在 EEA 之外的地区总是发送 ad_user_data 拒绝信号，系统就会显示此诊断信息。此问题会导致 EEA 以外的国家/地区的同意率为 0%，表明您可能已在全球范围内实现仅限 EEA 的意见征求设置。同意率为 0% 可能会导致衡量效果降低，还可能会中断无需征得用户同意即可在 EEA 以外国家/地区进行的再营销。如需解决此问题，请排查意见征求设置问题。
• 代码在网页上的位置过低：如果我们检测到您网站上的代码在网页上的位置过低，系统就会显示此诊断信息。代码的放置位置会极大地影响其加载和启用的速度。如果代码的位置过低，则可能会导致信号缺失，进而影响网站效果衡量功能和相关性能。若要解决此问题，请修正代码放置不当的问题。
• Google 代码已停止发送数据：如果您的代码已停止发送数据，导致转化未被统计，系统就会显示此诊断信息。请查看相关说明，了解如何使用 Tag Assistant 确保代码已正确添加到网站中。
  • 注意：如果 Google 代码之前一直在发送数据，但在过去 48 小时内未发送数据，系统会显示“代码已停止发送数据”提醒，并将代码状态显示为“紧急”。此提醒与“无最近的数据”状态不同，后者表示未曾从 Google 代码收到过任何数据。“代码已停止发送数据”提醒目前仅适用于多来源转化。如果您的多来源转化设置在过去 7 天内未收到来自代码的任何数据，系统就会显示此提醒。
• 缺少 EEA 用户意见征求数据：如果在欧洲经济区 (EEA) 境内通过 Google 代码发送的数据未标有用户同意情况，并且我们无法确定您是否已屏蔽代码，系统就会显示此诊断信息。如需解决此问题，请验证数据是否已标有用户同意情况。
• 更新用户意见征求设置：如果在欧洲经济区 (EEA) 境内通过 Google 代码发送的数据未标有用户同意情况，并且我们能够确定您为整个网站屏蔽了代码，系统就会显示此诊断信息。如需解决此问题，请参阅管理默认的意见征求设置，以证明数据是在征得用户同意的情况下发送的。
• 在您的 Shopify 商店中检测到不支持的代码植入：如果您的 Google 代码目前通过 Shopify 自定义像素运行，系统就会显示此诊断信息。如果您在 Google & YouTube 应用中配置了 Google 代码，可能会导致您的数据出现差异，并导致部分功能停止运行，或者导致在您的 Shopify 网站上出现重复衡量的情况。为确保衡量结果准确无误，请通过 Google & YouTube 应用迁移您的 Google 代码。详细了解如何通过 Shopify 上的 Google & YouTube 应用迁移 Google 代码。
• 您的部分着陆页未添加代码：如果广告素材和效果最大化广告系列的着陆页未添加代码，系统就会显示此诊断信息。着陆页会添加到相应 Google 代码的代码覆盖情况报告中。未添加代码的着陆页可能会影响衡量效果。如需解决此问题，请访问代码覆盖情况摘要，查找并修复未添加代码的着陆页。
• 缺少 gtag config 命令：如果我们检测到您的 Google 代码未正确配置，而这可能会导致您的媒体资源无法衡量自动事件，系统就会显示此诊断信息。如需解决此问题，请在您网站的所有网页中将 Google 代码配置代码放置在起始 <head> HTML 标记之后。详细了解如何在网站上设置 Google 代码。
• 缺少 Google 代码：如果 Google 跟踪代码管理器中的事件代码没有匹配的 Google 代码，系统就会显示此诊断信息。如需解决此问题，请为您的每个效果衡量产品（包括 Google Ads、Google Analytics 和 Floodlight）添加 Google 代码。
  • 注意：如果广告系列状态为“有效（配置有误）：您的网站缺少 Google 代码”，通常意味着您的广告系列在过去 28 天内未记录到任何可出价的转化。
• Google 代码缺少交易 ID：您的 Google 代码当前已在发送数据，但交易 ID 缺失或无效。交易 ID 是每笔交易的唯一标识符，有助于防止重复统计同一转化。此提醒目前仅适用于多来源转化。请查看相关说明，了解如何更新转化事件代码段，使其包含缺失的参数。
• 您的转化次数可能存在重复统计：在过去 2 天内，Google 代码与其他数据源之间的交易 ID 匹配率不足 10%。为确保出价和转化报告的准确性，请为每次转化使用唯一的交易 ID，并确保其在 Google 代码和线下数据源中保持一致。若要解决此问题，请为每次转化使用唯一的交易 ID，并确保其在线上和线下数据源中保持一致。
• 内容安全政策屏蔽了某些资源：如果网站的内容安全政策 (CSP) 未列出某些必需的代码资源的来源，导致这些资源被屏蔽，系统就会显示此诊断信息。您网站的 CSP 要求资源在获得明确批准后才能被访问，而屏蔽这些资源可能会导致您的 Google 代码无法加载或无法发送衡量数据。如需解决此问题，您可以使用 Google Tag Assistant，也可以更新网站的 CSP 以将必要的 Google 效果衡量端点列入许可清单。

我们正在逐步推出以下诊断功能和建议，目前您的账号可能还无法使用：

• 网站重定向会丢失点击数据：如果您网站中的重定向会丢失 GCLID（Google 点击标识符），系统就会显示此诊断信息。GCLID 有助于衡量用户从广告点击到在网站上完成转化的历程，并支持第一方衡量。丢失此类数据可能会影响广告效果衡量，并增加您摆脱第三方 Cookie 的难度。您需要确保在重定向期间，所有必要的信息都能顺利传递。如需解决此问题，请找出并修正服务器端代码，确保其包含 GCLID。
• 您的代码数据可能会受到限制：如果我们检测到您使用的是 Google 支持但未启用面向广告客户的 Google 代码网关的内容分发网络（例如 Cloudflare），系统就会显示此建议。要解决此问题，您可以启用面向广告客户的 Google 代码网关，也可以忽略该建议。详细了解如何在 Google 代码中使用 Cloudflare 设置面向广告客户的 Google 代码网关。

关闭诊断提醒

您还可以关闭一些不适用于预期配置或实现的诊断提醒。例如，我们建议您启用面向广告客户的 Google 代码网关，以防止丢失衡量信号。如果您暂时不想启用面向广告客户的 Google 代码网关，也不想让其影响 Google 代码诊断质量，可以关闭此提醒。

关闭诊断提醒

1. 在 Google 代码设置中，点击诊断标签页。
2. 在“代码质量”部分下，点击要关闭的操作项或代码问题的三点状菜单图标 。
3. 点击关闭。
4. （可选）系统会显示一个弹出式窗口，询问您是否确认关闭操作项。选择原因，然后点击是。

已忽略的问题将不再影响您的整体代码质量。系统会将已关闭的待办项移至有效待办项下方。

恢复已关闭的诊断提醒

1. 在 Google 代码设置中，点击诊断标签页。
2. 在“代码质量”部分底部，系统会列出您关闭的待办项。
3. 点击您要恢复的已关闭的待办项或代码问题的三点状菜单图标 。
4. 点击恢复。