偵錯事件

DebugView 可讓您以近乎即時的方式,在開發裝置上查看應用程式記錄的原始事件資料。這對於在開發的檢測階段進行驗證來說非常實用,有助於找出 Analytics (分析) 實作項目中的錯誤和錯誤,並確認所有事件和使用者屬性都已正確記錄。

啟用偵錯模式

一般來說,應用程式記錄的事件會在約一小時內以批次方式上傳,然後一起上傳。這個方法可以節省使用者裝置的電池用量,並降低網路數據用量。不過,為了驗證 Analytics (分析) 實作結果 (並在 DebugView 報表中查看 Analytics (分析)),您可以在開發裝置上啟用偵錯模式,以最短的延遲時間上傳事件。

iOS+

如要在開發裝置上啟用 Analytics (分析) 偵錯模式,請在 Xcode 中指定下列指令列引數:

-FIRDebugEnabled

系統會持續執行此行為,直到您指定下列指令列引數來明確停用偵錯模式為止:

-FIRDebugDisabled

如要新增這些引數,請編輯專案配置,並將新項目新增至「通過啟動的引數」。

Android

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

adb shell setprop debug.firebase.analytics.app PACKAGE_NAME

系統會持續執行這項行為,直到您執行下列指令明確停用偵錯模式為止:

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

網站

如要在瀏覽器中啟用 Analytics (分析) 偵錯模式,請安裝 Google Analytics Debugger Chrome 擴充功能。

安裝完成後,請啟用擴充功能並重新整理頁面。之後,擴充功能就會以偵錯模式記錄應用程式中的事件。

您可以在 Firebase 主控台中查看 DebugView 中記錄的事件。

製作事件資料報表

在開發裝置上啟用偵錯模式後,請在 Google Analytics (分析) 頂端導覽列中選取 StreamView 旁邊的箭頭並選取 DebugView,前往「DebugView」

在 Google Analytics (分析) 頂端的導覽列中,選取 StreamView 旁邊的箭頭並選取「DebugView」,即可前往 DebugView

接著,只要使用應用程式,即可查看應用程式事件記錄在 DebugView 報表中。

DebugView 報表。

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

秒動態

根據預設,系統會顯示過去 60 秒內記錄的事件清單。每個事件都會顯示時間戳記,對應至其在開發裝置上記錄的時間。只要按一下事件,就能查看與該事件相關的參數清單。

事件參數清單範例。

由於使用者屬性值會在應用程式使用期間變動,因此您會看到這項變更的項目。

使用者屬性範例。

分動態

這個串流會顯示一系列圓圈,每個圓圈都對應過去 30 分鐘內一分鐘。圓圈中的數字代表該分鐘內收到的事件數量。點選其中一個圓圈,即可在秒串流填入該分鐘內記錄的事件。這能讓您以更精細的方式查看過去 30 分鐘記錄的事件。

分鐘串流範例。

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

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

熱門事件表格範例。

裝置選取工具

由於許多不同的開發裝置可以啟用偵錯模式,因此您可以使用裝置選取器來選擇要讓 DebugView 報表聚焦的特定裝置。這可讓多個開發人員專注於自己的檢測和驗證工作,而不必互相干擾。

裝置選取器範例。