使用 DebugView 验证您的 Google Analytics(分析)配置

在开发过程中使用 DebugView 验证应用的 Google Analytics(分析)配置。

为了节省网络数据流量和延长移动设备的电池续航时间,Analytics(分析)部署会定期轮询使用情况数据(通常每小时一次)。不过在开发过程中,最好可以无需等待就能实时查看事件,以便根据需要进行调整。借助 DebugView,您就可以实时监控应用和/或网站的事件。

要使用 DebugView,您必须先在设备或网站上启用“调试”模式。

在移动设备或浏览器上启用

Android

要在 Android 模拟设备上启用 Analytics(分析)“调试”模式,请执行以下这行命令:

adb shell setprop debug.firebase.analytics.app <软件包名称>

“调试”模式将保持启用状态,直至您通过执行以下这行命令明确停用“调试”模式:

adb shell setprop debug.firebase.analytics.app .none.

iOS

要在开发设备上启用 Analytics(分析)“调试”模式,请在 Xcode 中指定以下命令行参数:

-FIRDebugEnabled

“调试”模式将保持启用状态,直至您通过指定以下命令行参数明确停用“调试”模式:

-FIRDebugDisabled

浏览器

要在浏览器中启用 Analytics(分析)“调试”模式,请安装 Google Analytics Debugger Chrome 扩展程序

安装此扩展程序后,将其启用并刷新页面。从该时间点开始,此扩展程序将以调试模式记录应用中的事件。

您可以在 Firebase 控制台中查看在 DebugView 中记录的事件。

注意:在使用 DebugView 之前,应确保设备时间准确无误。设备时钟若有偏差,则会导致 Analytics(分析)报告中出现事件延迟或缺失。

在网站上启用

使用 gtag.js 为所有事件启用“调试”模式

添加 'debug mode' = true 参数;例如:

gtag('config', 'G-12345ABCDE',{'debug_mode':true});

使用 gtag.js 为个别事件启用“调试”模式

gtag('event', 'xyz', {
  'debug_mode':true
});

使用 Google 跟踪代码管理器为所有事件启用“调试”模式

使用“Google Analytics(分析):GA4 配置”代码类型。

添加字段 'debug mode' = true

使用 Google 跟踪代码管理器为个别事件启用“调试”模式

使用“Google Analytics(分析):GA4 事件”代码类型。

将事件的 debug_mode 字段设置为 true:

报告

如果您在客户端上实施了隐私控制,或者您已实施了意见征求模式并且未就 Google Analytics(分析)Cookie 征得用户的同意,则在“调试”模式下,事件不会显示。

在开发设备上启用“调试”模式之后,转到 DebugView,然后开始使用应用,就可以看到应用的事件被记录到 DebugView 报告中。

秒流(中间列)显示过去 60 秒内记录的事件。分钟流(左侧列)显示过去 30 分钟内一系列归档的事件。右侧列显示 30 分钟内记录的热门事件以及当前所选开发设备的当前用户属性

秒流

默认情况下,您将看到过去 60 秒内记录的事件的列表。每个事件都会显示与其在开发设备上的记录时间相对应的时间戳。您可以点击某个事件查看与该事件关联的参数的列表。随着用户属性值在应用使用过程中发生变化,您会看到事件显示在信息流中,最新的事件显示在最上面。

分钟流

此信息流会显示一系列圆圈,一个圆圈对应着过去 30 分钟内的一分钟时间。圆圈内的数字表示在相应分钟内收到的事件数。如果点击其中一个圆圈,系统会将在该分钟内记录的事件填充到秒流中。这有助于您更详细地查看过去 30 分钟内记录的事件。

“热门事件”和“当前用户属性”

“热门事件”表显示 30 分钟内记录的热门事件。“当前用户属性”表显示当前所选开发设备的用户属性组的最新状态。

设备选择器

由于很多不同的开发设备都可以启用“调试”模式,因此您可以使用设备选择器来选择 DebugView 报告将关注的特定设备。这样,多名开发者可以专注于他们自己的检测和验证工作,而不会相互影响。设备选择器菜单位于报告的左上方,标记为调试设备

该内容对您有帮助吗?
您有什么改进建议?