記錄事件

選取平台： iOS+ Android Web Flutter Unity C++


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

Analytics 會自動記錄部分事件，您不必新增任何程式碼，就能接收這些事件。如果應用程式需要收集其他資料，您最多可以在應用程式中記錄 500 種不同的 Analytics 事件類型。應用程式記錄的事件總量沒有限制。請注意，事件名稱區分大小寫。也就是說，如果事件只有名稱大小寫不同，記錄上仍會顯示為兩組不同的事件。

事前準備

請確認您已設定專案，並可按照「開始使用 Analytics」一文所述存取 Analytics。

記錄事件

建立 FirebaseAnalytics 執行個體後，您可以使用該執行個體透過 logEvent() 方法記錄事件。

為協助您快速上手，Analytics SDK 定義了多種建議事件，這些事件在不同類型的應用程式中都很常見，包括零售和電子商務、旅遊和遊戲應用程式。如要進一步瞭解這些事件和使用時機，請參閱「建議事件」。

您可以在下列位置找到建議事件類型的導入詳細資料：

以下範例說明如何記錄 SELECT_CONTENT 事件：

Kotlin 

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 報表中。方法是在 Firebase 控制台中，依序前往「Analytics」 >「Custom Definitions」(自訂定義)。

    自訂參數可用於目標對象定義，可套用至每份報表。如果應用程式已連結至 BigQuery 專案，自訂參數也會包含在匯出至 BigQuery 的資料中。如需查詢範例等資訊，請參閱「Google Analytics 4 BigQuery Export」。

  • VALUE 參數：VALUE 是一般用途參數，可用於累積與事件相關的重要指標。例如收益、距離、時間和點數。

如果應用程式有特殊需求，而建議事件類型無法滿足，您可以記錄自訂事件，如下例所示：

Kotlin 

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 

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java 

Bundle parameters = new Bundle();
parameters.putString("level_name", "Caverns01");
parameters.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 控制台中，您可以依序前往「 Analytics」 > 「Events」資訊主頁，查看事件的匯總統計資料。

請注意這個資訊主頁的下列事項：

  • 資訊主頁會顯示事件報表，這些報表是系統根據應用程式記錄的每種事件類型自動建立。

  • 資訊主頁一整天內會定時更新。如要立即測試，請按照本指南上一節所述，使用 Logcat 輸出內容。