記錄事件

您可以透過事件深入分析應用程式情況，例如使用者動作、系統事件或錯誤。

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

事前準備

使用 Google Analytics (分析) 之前，您必須先：

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

    • 如果您的 Unity 專案已使用 Firebase，表示該專案已完成註冊並設定 Firebase。

    • 如果您沒有 Unity 專案，可以下載範例應用程式。

  • 在 Unity 專案中新增 Firebase Unity SDK (尤其是 FirebaseAnalytics.unitypackage)。

請注意，將 Firebase 新增至 Unity 專案涉及到 Firebase 主控台和開放式 Unity 專案中的工作 (例如從主控台下載 Firebase 設定檔，再移至 Unity 專案)。

記錄事件

初始化 Firebase.Analytics.FirebaseAnalytics 模組後，即可用來記錄與 LogEvent() 方法的事件。

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

您可以在下列位置查看建議事件的實作詳細資料：

  • 建議事件：查看 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+

事件會記錄到主控台中，您可以在執行應用程式時透過 XCode 查看。

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

您可以在 Firebase 主控台資訊主頁中查看 Analytics (分析) 事件的匯總統計資料。這些資訊主頁在一天當中會定期更新。如要立即測試，請使用上一節所述的 Logcat 輸出內容。

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

  1. 在 Firebase 控制台開啟專案。
  2. 從選單中選取「Analytics」(分析)，即可查看 Analytics (分析) 報表資訊主頁。

「事件」分頁會顯示系統為應用程式記錄的每種 Analytics (分析) 事件自動建立的事件報表。進一步瞭解資訊主頁。