記錄事件

選取平台：

iOS+ Android 網頁 Flutter Unity C++

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

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事件相關的重要指標。例如收益、距離、時間和點數。

如果應用程式有特定需求，建議的 AnalyticsEvent 類型無法滿足，您可以記錄自己的自訂 AnalyticsEvents，如以下範例所示：

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

在記錄輸出中查看事件

在資訊主頁中查看 Analytics 事件

在 Firebase 控制台中，您可以在「Analytics」(數據分析) >「Events」(事件) 資訊主頁中，查看事件的匯總統計資料。

請注意下列資訊主頁的相關事項：

• 資訊主頁會顯示系統為應用程式記錄的每種不同事件類型，自動建立的事件報表。

• 資訊主頁會在一天內定期更新。如要立即測試，請使用 Xcode 偵錯控制台或 Logcat 輸出內容，如本指南上一節所述。

進一步瞭解資訊主頁。