利用 DebugView 驗證 Analytics (分析) 設定

在開發過程中利用 DebugView 為應用程式驗證 Analytics (分析) 設定。

為了節省行動裝置的網路數據用量及提高電池續航力,Analytics (分析) 會定期 (通常為每小時一次) 輪詢使用資料。但在部署期間,您會需要立即查看事件資料並採行必要調整,而 DebugView 正是您即時監控應用程式和/或網站事件的好幫手。

如要使用 DebugView,您必須先在裝置或網站上啟用偵錯模式。

在行動裝置或瀏覽器上啟用

Android

如要在 Android 模擬裝置上啟用 Analytics (分析) 偵錯模式,請執行下列指令列:

adb shell setprop debug.firebase.analytics.app <package_name>

偵錯模式會維持啟用狀態,直到您執行下列指令列來明確停用偵錯模式為止:

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:

報表

如果您已在用戶端上導入隱私權控制項,或是在導入同意聲明模式後使用者尚未授予 Analytics (分析) Cookie 同意聲明,那麼偵錯模式就不會顯示任何事件。

在開發裝置上啟用偵錯模式後,請前往「DebugView」,並開始使用您的應用程式,即可看見您的應用程式事件即時記錄在 DebugView 報表中。

秒動態 (中間欄) 列出最近 60 秒內記錄到的事件,分動態 (左欄) 中顯示的則是最近 30 分鐘內的一系列事件封存。右欄列的是在 30 分鐘內記錄到的熱門事件,以及現在選取的開發裝置的目前使用者屬性

秒動態

根據預設,您會看到系統在過去 60 秒內記錄的事件。每個事件都會顯示與開發裝置所記錄時間相對應的時間戳記,您只要點選某個事件,就能查看相關的參數。隨著使用者屬性值在應用程式使用期間有所改變,事件會持續出現在動態中,最晚發生的事件會顯示在最上方。

分動態

這個動態會顯示許多圓圈。每個圓圈分別代表最近 30 分鐘內的每一分鐘,圓圈中的數字則是系統在該分鐘內收到的事件數。您可以點選任一個圓圈,將系統在該分鐘內記錄到的事件填進秒動態,以便查看過去 30 分鐘內所記錄事件的相關詳細資料。

熱門事件與目前使用者屬性

「熱門事件」表格會列出系統在過去 30 分鐘內記錄到的熱門事件,「目前使用者屬性」表格則針對目前選取的開發裝置,顯示使用者屬性組合的最新狀態。

裝置選取工具

由於許多不同的開發裝置均可啟用偵錯模式,因此您可以透過「裝置選取工具」來選擇要在 DebugView 報表中顯示的特定裝置。如此一來,各開發人員就能專心處理自己的檢測和驗證工作,不會互相干擾。裝置選取工具選單位於報表左上角,標示為「偵錯裝置」

這對您有幫助嗎?
我們應如何改進呢?