本指南可帮助您确认 Google Analytics 代码是否已正确安装并正在发送数据,如果您未看到预期的数据,本指南还提供了诊断常见问题的步骤。
即时验证方法
这些工具可帮助您在设置代码后立即检查代码是否触发:
- Google Analytics DebugView:启用 DebugView 后,您可以在与网站或应用互动时实时查看事件。这是确认事件和参数是否正确发送的最佳方式。请参阅在 DebugView 中监控事件。
- Google Tag Assistant Companion:此浏览器扩展程序可帮助验证网站上的 Google 代码 (gtag.js) 植入情况。它会显示正在触发哪些代码以及正在传递哪些数据。请参阅关于 Tag Assistant。
- 浏览器开发者工具:
- “网络”标签页:打开浏览器的开发者工具(例如 Chrome DevTools),然后在浏览网站时查找对
google-analytics.com/g/collect或analytics.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_view、session_start、first_visit和user_engagement。 - 基本维度:在报告中,您会开始看到网页路径、来源/媒介、设备类别、国家/地区等维度的数据。
数据需要多长时间才能显示?
- DebugView:事件会在几秒内显示。
- 实时报告:数据会在几分钟内显示。
- 标准报告:需要 24-48 小时才能完成数据处理并生成报告。
如果您已完成上述步骤,但仍然看不到数据,请仔细检查代码植入情况,并参阅 Google Analytics 帮助中心。