Catch up on highlights from Firebase at Google I/O 2023. Learn more

記錄事件

本指南向您展示如何在您的應用程序中記錄事件。

事件可以讓您深入了解您的應用中正在發生的事情,例如用戶操作、系統事件或錯誤。

Analytics 會自動為您記錄一些事件;您無需添加任何代碼即可接收它們。如果您的應用需要收集額外數據,您可以在您的應用中記錄多達 500 種不同的分析事件類型。您的應用記錄的事件總量沒有限制。請注意,事件名稱區分大小寫,記錄兩個名稱僅大小寫不同的事件將導致兩個不同的事件。

在你開始之前

確保您已設置項目並且可以訪問 Analytics,如開始使用 Analytics中所述。

記錄事件

創建FirebaseAnalytics實例後,您可以使用它通過logEvent()方法記錄事件。

為幫助您入門,Analytics SDK 定義了一些推薦事件,這些事件在不同類型的應用程序中很常見,包括零售和電子商務、旅遊和遊戲應用程序。要了解有關這些事件以及何時使用它們的更多信息,請參閱推薦事件

您可以在以下位置找到推薦事件類型的實施細節:

以下示例演示如何記錄SELECT_CONTENT事件:

Kotlin+KTX

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}

Java

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);

除了規定的參數外,您還可以將以下參數添加到任何事件中:

  • 自定義參數:自定義參數可用作Analytics 報告中的維度或指標。您可以為非數字事件參數數據使用自定義維度,為更好地以數字表示的任何參數數據使用自定義指標。使用 SDK 記錄自定義參數後,註冊維度或指標以確保這些自定義參數顯示在 Analytics 報告中。通過以下方式執行此操作: Analytics > Events > Manage Custom Definitions > Create Custom Dimensions

    自定義參數可用於可應用於每個報告的受眾定義。如果您的應用鏈接到BigQuery 項目,則自定義參數也包含在導出到 BigQuery 的數據中。在Google Analytics 4 BigQuery Export中查找示例查詢和更多內容。

  • VALUE參數: VALUE是一個通用參數,可用於累積與事件相關的關鍵指標。示例包括收入、距離、時間和積分。

如果您的應用程序具有推薦事件類型未涵蓋的特定需求,您可以記錄自己的自定義事件,如本例所示:

Kotlin+KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}

Java

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

設置默認事件參數

您可以使用setDefaultEventParameters跨事件記錄參數。默認參數與記錄的所有未來事件相關聯。

與自定義參數一樣,註冊默認事件參數以確保它們出現在 Analytics 報告中。

Kotlin+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

如果在logEvent()方法中指定了參數,則使用該值而不是默認值。

要清除默認參數,請調用setDefaultEventParameters方法並將參數設置為null

查看 Android Studio 調試日誌中的事件

您可以啟用詳細日誌記錄來監視 SDK 的事件日誌記錄,以幫助驗證事件是否被正確記錄。這包括自動和手動記錄的事件。

您可以使用一系列 adb 命令啟用詳細日誌記錄:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

此命令在 Android Studio logcat 中顯示您的事件,幫助您立即驗證是否正在發送事件。

在儀表板中查看事件

您可以在 Firebase 控制台儀表板中查看有關事件的匯總統計信息。這些儀表板全天定期更新。對於即時測試,請使用上一節中所述的 logcat 輸出。

您可以從 Firebase 控制台的事件儀表板訪問此數據。此儀表板顯示為您的應用程序記錄的每種不同類型的事件自動創建的事件報告。