了解 2023 年 Google I/O 大会上介绍的 Firebase 亮点。了解详情

調試事件

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 Debugger Chrome 擴展程序。

安裝後,啟用擴展並刷新頁面。從那時起,該擴展程序將以調試模式在您的應用程序中記錄事件。

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

事件數據報告

在開發設備上啟用調試模式後,通過選擇 Google Analytics 頂部導航欄上StreamView旁邊的箭頭並選擇 DebugView 導航到 DebugView。

通過選擇 Google Analytics(分析)頂部導航欄上 StreamView 旁邊的箭頭並選擇 DebugView,導航到 DebugView

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

調試視圖報告。

Seconds 流(中間列)顯示最近 60 秒內記錄的事件。分鐘流(左欄)顯示了過去 30 分鐘內的一系列事件存檔。右欄顯示 30 分鐘內記錄的熱門事件以及當前所選開發設備的當前用戶屬性。

秒流

默認情況下,您會看到最近 60 秒內記錄的事件列表。每個事件都顯示一個時間戳,該時間戳對應於它在開發設備上的登錄時間。您可以單擊一個事件以查看與該事件關聯的參數列表。

事件參數的示例列表。

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

示例用戶屬性。

分鐘流

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

分鐘流的示例。

熱門事件和當前用戶屬性

熱門事件表顯示了 30 分鐘內記錄的熱門事件。當前用戶屬性表顯示當前所選開發設備的用戶屬性集的最新狀態。

頂級事件表的示例。

設備選擇器

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

設備選擇器的示例。