Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

記錄事件

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

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

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

在你開始之前

請確保您已經設置了您的項目,如描述可以訪問Analytics(分析)獲取與分析開始

記錄事件

你已經創建了一個後FirebaseAnalytics例如,你可以用它來記錄事件與logEvent()方法。

為了幫助您入門,Analytics SDK 定義了許多在不同類型的應用程序(包括零售和電子商務、旅遊和遊戲應用程序)中常見的建議事件。要了解更多有關這些事件和何時使用它們,瀏覽事件和屬性在火力地堡幫助中心文章。

您可以在以下位置找到建議的事件類型的實施詳細信息:

下面的例子演示了如何登錄一個SELECT_CONTENT事件:

爪哇

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);

科特林+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")
}

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

  • 自定義參數:自定義參數可以登記在Analytics報告中報告。它們也可以用作過濾器的觀眾定義,可以應用到每一個報告。自定義的參數也包含在數據導出到BigQuery的,如果您的應用程序鏈接到的BigQuery項目。

  • VALUE參數: VALUE是一個通用的參數,其用於累積的關鍵度量涉及的事件是有用的。示例包括收入、距離、時間和積分。

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

爪哇

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

科特林+KTX

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

設置默認事件參數

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

爪哇

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

科特林+KTX

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

firebaseAnalytics.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 輸出。

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