記錄事件

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

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 執行應用程式時查看。

在資訊主頁中查看 Analytics 事件

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

如要在 Firebase 控制台中存取這項資料，請按照下列步驟操作：

  1. 在 Firebase 控制台中開啟專案。
  2. 選取選單中的 Analytics，即可查看 Analytics 報表資訊主頁。

「事件」分頁會顯示應用程式記錄的每種不同類型 Analytics 事件，系統會自動為這些事件建立事件報表。進一步瞭解資訊主頁。