記錄事件

本指南說明如何記錄應用程式中的事件。

事件可讓您深入瞭解應用程式情況，例如使用者動作、系統事件或錯誤。

Analytics (分析) 會自動記錄部分事件，您不必新增任何程式碼就能接收事件。如果應用程式需要收集其他資料，您最多可以在應用程式中記錄 500 種 Analytics (分析) 事件類型。應用程式記錄的事件總數沒有上限。請注意，事件名稱會區分大小寫；此外，記錄兩個名稱只有大小寫不同的事件時，會產生兩個不同的事件。

事前準備

請確認您已設定專案，並可按照「開始使用 Analytics (分析)」中的說明存取 Analytics (分析)。

記錄事件

建立 FirebaseAnalytics 執行個體後，您便可以將其與 logEvent() 方法搭配使用來記錄事件。

為協助您踏出第一步，Analytics (分析) SDK 定義了各類應用程式常見的幾個建議事件，包括零售和電子商務、旅遊和遊戲應用程式。如要進一步瞭解這些事件及使用時機，請參閱「建議事件」。

如需建議事件類型的實作詳細資料，請參閱下列位置：

建議事件：請參閱 com.google.firebase.analytics.FirebaseAnalytics.Event 類別參考資料。
預先定義的參數：請參閱 com.google.firebase.analytics.FirebaseAnalytics.Param 參考資料。

以下示範如何記錄 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")
}MainActivity.kt

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);MainActivity.java

除了上述參數外，您也可以在任何事件中加入下列參數：

自訂參數：自訂參數可在 Analytics (分析) 報表中做為維度或指標使用。自訂維度適用於非數值事件參數資料和自訂指標，能以數字方式呈現任何參數資料。使用 SDK 記錄自訂參數後，請註冊維度或指標，確保這些自訂參數會顯示在 Analytics (分析) 報表中。方法是依序點選 [Analytics (分析)] > [事件] > [管理自訂定義] > [建立自訂維度]

自訂參數可用於目標對象定義，也可套用至每份報表。如果應用程式已連結至 BigQuery 專案，匯出至 BigQuery 的資料也會包含自訂參數。如需查詢範例和更多資訊，請參閱 Google Analytics (分析) 4 BigQuery Export。
VALUE 參數：VALUE 是一般用途參數，有助於累積與事件相關的重要指標。例如收益、距離、時間和點數。

如果建議事件類型未涵蓋應用程式的特定需求，您可以記錄自己的自訂事件，如以下範例所示：

Kotlin+KTX

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

Java

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

設定預設事件參數

您可以使用 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() 方法中指定參數，系統會使用該值，而非預設值。

如要清除預設參數，請在參數設為 null 時呼叫 setDefaultEventParameters 方法。

在 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 控制台的「事件」資訊主頁存取這些資料。這個資訊主頁會顯示系統為應用程式記錄的每種不同事件類型自動建立的事件報表。