記錄事件

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

Google Analytics 會自動記錄 事件; 您不需要新增任何程式碼如果您的應用程式需要收集 額外資料,您最多可以記錄 500 種 Analytics 事件類型 。應用程式記錄的事件總數沒有上限。 請注意,事件名稱有大小寫之分,且要記錄的兩個事件 名稱不同,會導致兩個不同的事件。

事前準備

使用前 Google Analytics、 請完成下列操作:

  • 註冊 Unity 專案,並將其設定為使用 Firebase。

    • 如果您的 Unity 專案已在使用 Firebase, 已完成註冊和設定程序。

    • 如果您沒有 Unity 專案,可以 範例應用程式

  • Firebase Unity SDK (特別是 FirebaseAnalytics.unitypackage) 新增至 Unity 專案

請注意,將 Firebase 新增至 Unity 專案時,必須一併執行以下兩者的工作: Firebase 控制台,在開啟的 Unity 專案中 (例如,您可以從控制台下載 Firebase 設定檔,然後 放入您的 Unity 專案中)。

記錄事件

初始化 Firebase.Analytics.FirebaseAnalytics 模組後, 方便您透過 LogEvent() 方法記錄事件。

為協助您上手,Analytics SDK 定義了 不同類型的應用程式所通用的建議事件,包括 零售業、電子商務、旅遊和遊戲應用程式如要進一步瞭解這些事件 以及使用時機,請參閱「建議事件」一文 一文。

您可以在下列資源中找到建議事件的導入詳細資料 地區:

  • 建議事件:查看 Event 常數清單。
  • 指定參數:請參閱 Parameters 常數清單。

下列範例說明如何記錄建議的 SELECT_CONTENT 事件:

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
  new Firebase.Analytics.Parameter(
    "favorite_food", mFavoriteFood),
  new Firebase.Analytics.Parameter(
    "user_id", mUserId)
);

除了規定的參數外,您還可以新增下列參數 附加至任何事件:

  • 自訂參數:自訂參數不會直接顯示在 但可以在 Analytics 報表中做為篩選器 可套用至每一份報表的目標對象定義。自訂 參數也會包含在匯出至 BigQuery 的資料中 應用程式已連結至 BigQuery 專案

  • VALUE 參數:VALUE 是一般用途的參數 適合用來累積 Analytics 事件。例如收益、距離、時間和點數。

如果您的應用程式有建議項目以外的特定需求 也可以使用 Analytics 事件類型記錄自訂 Analytics 事件 如以下範例所示:

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

在記錄輸出內容中查看事件

Android

您可以在 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 中顯示事件,協助 立即確認事件是否正在傳送

iOS+

事件會記錄到控制台中,且可在執行應用程式時查看 取得相關資訊

在資訊主頁中查看數據分析事件

如要查看 Analytics 事件的匯總統計資料,請前往 Firebase 控制台資訊主頁。這些資訊主頁會定期更新 整天下來。如要立即測試,請使用 Logcat 輸出內容, 請參閱上一節的說明

如何在 Firebase 控制台存取這些資料:

  1. Firebase 控制台開啟專案。
  2. 從選單中選取「Analytics」以查看 Analytics 報告資訊主頁。

「事件」分頁會顯示: 也就是系統記錄的 進一步瞭解資訊主頁