記錄事件

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

Google Analytics 會自動記錄部分事件，您不需要新增任何程式碼即可接收這些事件。如果應用程式需要收集其他資料，您可以在應用程式中記錄最多 500 個不同的 Analytics 事件類型。應用程式記錄的事件總量沒有上限。請注意，事件名稱有區分大小寫，如果兩個事件的名稱只有大小寫不同，系統會將其視為兩個不同的事件。

事前準備

如要使用 Google Analytics，您必須先完成下列步驟：

  • 註冊 Unity 專案並設定使用 Firebase。

    • 如果 Unity 專案已使用 Firebase，則表示已為 Firebase 註冊及設定。

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

  • 將 Firebase Unity SDK (具體來說是 FirebaseAnalytics.unitypackage) 新增至 Unity 專案。

請注意，將 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 報表資訊主頁。

「Events」分頁會顯示系統為應用程式記錄的每種 Analytics 事件類型自動建立的事件報表。如要進一步瞭解資訊主頁，請參閱這篇文章。