更新时间:2025年1月8号
这一篇来介绍GA4中DebugView的用法,如果你想用Tag Assistant去调试,请看:Google Tag Manager中新的预览调试方式——Tag Assistant。
什么是DebugView?
DebugView是GA4内置的实时调试工具,能显示当下触发的所有事件与参数,常用于验证:事件名称、事件参数、用户属性、电商参数是否准确。
对于开发、分析师、实施人员来说,是GA4最基础的debug工具。
三种进入DebugView调试状态的方法
GA4 的 DebugView 默认不会接收所有用户数据,必须进入“调试模式”才会显示。以下是三种主流方式:
- 在 GTM 设置
debug_mode = true:在GTM中的「要设置字段」中将debug_mode设置为true,然后点击GTM的「预览」 - 使用 Chrome 插件 Google Analytics Debugger:点击插件,显示为 ON 即表示调试启用,刷新网页后,事件会进入DebugView
- 从 Tag Assistant 中预览(推荐):直接使用GTM点击「预览」
建议使用第三方式,最简单方便。
DebugView调试界面介绍
进入调试模式后,在GA4中点击「配置」——「 媒体资源设置」——「数据显示」——「DebugView」(在媒体资源那一列),打开DebugView报告如下:
- 设备选择器:可以选择特定设备,看特定设备的调试数据。这样,多名开发者可以专注于他们自己的检测和验证工作,而不会相互影响。
- 分钟流:此信息流会显示一系列圆圈,一个圆圈对应着过去 30 分钟内的一分钟时间。圆圈内的数字表示在相应分钟内收到的事件数。如果点击其中一个圆圈,系统会将在该分钟内记录的事件填充到秒流中。
- 秒流:默认情况下,您将看到过去 60 秒内记录的事件的列表。每个事件都会显示与其在开发设备上的记录时间相对应的时间戳。点击某个事件查看与该事件关联的参数的列表。随着用户属性值在应用使用过程中发生变化,您会看到事件显示在信息流中,最新的事件显示在最上面。
- 热门事件:表显示 30 分钟内记录的热门事件。
- 当前用户属性:表显示当前所选开发设备的用户属性组的最新状态。
Debugview的调试用法
DebugView的用法是:先选择设备,再点击分钟流,然后点击秒流,找到对应的事件,再看事件里的参数和用户属性是否准确。
进入到调试状态后,在GA4里点击「管理」——「媒体资源设置」——「数据显示」——「Debugview」,就可以看到Debugview的调试界面:
Step 1:先选设备
在设备选择器里选择你自己的调试设备,将自己的数据过滤出来:
Step 2:选择分钟流→ 秒流
模拟用户行为,然后先点击分钟流,然后点击秒流,找到测试的事件:
如果没有事件:
- 事件没触发
- 或 GA4 tag 没加载
- 或未进入调试状态
需要回头重新检查设置
Step 3:确认参数是否准确
点击测试事件,就可以查看事件参数和用户属性,确认值是否准确:
如果参数值都准确,那就配置没问题。
DebugView的优缺点
- DebugView的优点:内置调试工具,不仅支持网站,还支持APP,显示信息实时更新,适合快速验证事件是否正常发送
- DebugView的缺点:DebugView能判断是否有错,但定位不了错在哪里,深度排错仍需依赖 Tag Assistant
常见错误
推荐阅读:DebugView里的Bug和常见错误(2023)








