記錄事件

選取平台：

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

如果應用程式有特定需求，但建議的 Analytics 事件類型不適用，您可以記錄自訂 Analytics 事件，如下例所示：

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

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

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

在 Firebase 控制台中，您可以依序前往「 Analytics」 > 「Events」資訊主頁，查看事件的匯總統計資料。

請注意這個資訊主頁的下列事項：

• 資訊主頁會顯示事件報表，這些報表是系統根據應用程式記錄的每種事件類型自動建立。

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

進一步瞭解資訊主頁。