調試事件

DebugView 可讓您近乎即時地查看開發裝置上的應用程式記錄的原始事件資料。這對於開發偵測階段的驗證非常有用,可以幫助您發現 Analytics 實作中的錯誤和失誤,並確認所有事件和使用者屬性均已正確記錄。

啟用調試模式

通常,您的應用程式記錄的事件會在大約一小時的時間內批次處理並一起上傳。這種方法可以節省最終用戶設備的電池並減少網路數據的使用。但是,為了驗證您的 Analytics 實施(並且為了在 DebugView 報告中查看您的 Analytics),您可以在開發裝置上啟用偵錯模式,以便以最小的延遲上傳事件。

iOS+

若要在開發裝置上啟用 Analytics 偵錯模式,請在 Xcode 中指定下列命令列參數:

-FIRDebugEnabled

此行為將持續存在,直到您透過指定以下命令列參數明確停用偵錯模式:

-FIRDebugDisabled

您可以透過編輯專案的方案並向「啟動時傳遞的參數」新增條目來新增這些參數。

安卓

若要在 Android 裝置上啟用 Analytics 偵錯模式,請執行下列命令:

adb shell setprop debug.firebase.analytics.app PACKAGE_NAME

此行為將持續存在,直到您透過執行以下命令明確停用偵錯模式:

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

網路

若要在瀏覽器中啟用 Analytics 偵錯模式,請安裝Google Analytics 偵錯器Chrome 擴充功能。

安裝後,啟用擴充功能並刷新頁面。從那時起,擴充功能將以偵錯模式記錄應用程式中的事件。

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

事件數據報告

在開發裝置上啟用偵錯模式後,透過選擇 Google Analytics 頂部導覽列上StreamView旁邊的箭頭並選擇 DebugView 導覽至 DebugView。

透過選擇 Google Analytics 頂部導覽列上 StreamView 旁邊的箭頭並選擇 DebugView 導覽至 DebugView

然後,只需開始使用您的應用程式即可查看 DebugView 報告中記錄的應用程式事件。

調試視圖報表。

秒流(中間列)顯示過去 60 秒內記錄的事件。分鐘流(左欄)顯示過去 30 分鐘內的一系列事件檔案。右欄顯示 30 分鐘內記錄的熱門事件以及目前所選開發設備的目前使用者屬性。

秒流

預設情況下,您將看到過去 60 秒內記錄的事件清單。每個事件都會顯示一個時間戳,該時間戳對應於其在開發設備上的記錄時間。您可以按一下某個事件來查看與該事件關聯的參數清單。

事件參數的範例清單。

當使用者屬性值在應用程式使用過程中發生變化時,您將看到該變更的條目。

用戶屬性範例。

分鐘流

此流顯示一系列圓圈,每個圓圈對應於過去 30 分鐘內的一分鐘時間。圓圈中的數字表示該分鐘內收到的事件數。點擊其中一個圓圈將在秒流中填入該分鐘內記錄的事件。這有效地允許您詳細檢查過去 30 分鐘內記錄的事件。

分鐘流的範例。

熱門事件和當前用戶屬性

主要事件表顯示 30 分鐘內記錄的主要事件。目前使用者屬性表顯示目前所選開發設備的使用者屬性集的最新狀態。

熱門事件表的範例。

裝置選擇器

由於許多不同的開發設備都可以啟用偵錯模式,因此您可以使用裝置選擇器來選擇 DebugView 報告將關注的特定裝置。這使得多個開發人員能夠專注於自己的檢測和驗證工作,而不會相互影響。

設備選擇器的範例。