验证 Google Analytics 设置并排查问题

本指南可帮助您确认 Google Analytics 代码是否已正确安装并正在发送数据,如果您未看到预期的数据,本指南还提供了诊断常见问题的步骤。

即时验证方法

这些工具可帮助您在设置代码后立即检查代码是否触发:

  • Google Analytics DebugView:启用 DebugView 后,您可以在与网站或应用互动时实时查看事件。这是确认事件和参数是否正确发送的最佳方式。请参阅在 DebugView 中监控事件
  • Google Tag Assistant Companion:此浏览器扩展程序可帮助验证网站上的 Google 代码 (gtag.js) 植入情况。它会显示正在触发哪些代码以及正在传递哪些数据。请参阅关于 Tag Assistant
    • 浏览器开发者工具
    • “网络”标签页:打开浏览器的开发者工具(例如 Chrome DevTools),然后在浏览网站时查找对 google-analytics.com/g/collectanalytics.google.com/g/collect 的网络请求。您应该会看到这些请求在每次网页加载时以及针对事件触发。200 OK 状态代码表示传输成功。
    • “控制台”标签页:检查是否存在与 gtag.js 或网站代码相关的任何 JavaScript 错误,这些错误可能会阻止代码运行。

查看 Google Analytics 报告

  • 实时报告:在代码正确触发后几分钟内,数据应该就会开始显示在实时报告中。您应该会看到网页浏览、事件和活跃用户。
  • 标准报告:标准报告中的大多数数据需要 24-48 小时才能完全处理完毕并可供使用。如果您没有立即在实时报告和 DebugView 之外看到完整的数据,请不要惊慌。

常见设置问题及解决方法

  • 衡量 ID 不正确:请确保 gtag('config', 'G-XXXXXX') 调用中的衡量 ID 与 Google Analytics 网站数据流设置中的 ID 完全一致。衡量 ID 中的错别字是最常见且最容易犯的设置错误之一,因此请仔细检查。
  • 部分网页上未添加代码:Google 代码段必须位于您要跟踪的每个网页<head> 部分中。
  • 代码放置位置不正确:全局网站代码 (gtag.js) 应尽可能放置在 HTML 的 <head> 中。
  • 意见征求模式问题:如果您已实现意见征求模式,请确保代码未被不当阻止。代码只有在用户授予所需同意情况后才会触发。请使用 Tag Assistant 调试同意情况。请参阅排查意见征求模式问题
    • 广告拦截器和隐私保护扩展程序:某些浏览器扩展程序可能会阻止 Google Analytics 脚本运行。请在无痕式窗口或停用扩展程序的其他浏览器中进行测试。
  • Google Analytics 过滤器:检查您的 Google Analytics 媒体资源设置(管理 > 数据设置 > 数据过滤器)中是否有任何数据过滤器处于有效状态,这些过滤器可能会排除您要查找的数据。
  • 缓存:浏览器或服务器端缓存可能会提供不含代码的旧版网页。添加代码后,请清除缓存。

预期情况:初始数据

数据开始流动后,您应该会看到:

  • 自动收集的事件:系统会默认收集 page_viewsession_startfirst_visituser_engagement
  • 基本维度:在报告中,您会开始看到网页路径来源/媒介设备类别国家/地区等维度的数据。

数据需要多长时间才能显示?

  • DebugView:事件会在几秒内显示。
  • 实时报告:数据会在几分钟内显示。
  • 标准报告:需要 24-48 小时才能完成数据处理并生成报告。

如果您已完成上述步骤,但仍然看不到数据,请仔细检查代码植入情况,并参阅 Google Analytics 帮助中心