記錄事件

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

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

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()敬上方法，便會使用該值而非預設值。

如要清除預設參數，請呼叫 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 輸出內容，請參閱上一節的說明

如要存取這類資料，請前往事件資訊主頁。這個資訊主頁會顯示事件報表系統會根據記錄到的每種事件類型，