記錄事件


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

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

Analytics 會自動記錄部分活動記錄 事件；你不是 必須新增任何程式碼才能接收代碼。如果您的應用程式需要收集 資料中，您最多可以在應用程式中記錄 500 種不同的 Analytics 事件類型。 應用程式記錄的事件總數沒有上限。請注意， 名稱有大小寫之分，且記錄的兩個事件名稱只有 會導致兩個不同的事件。

事前準備

請確認您已設定專案，且可使用以下身分存取 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")
}
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 輸出內容， 請參閱上一節的說明

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