開始使用 Unity 專用 Google Analytics (分析)

選取平台: iOS+ Android Web Flutter Unity C++


Google Analytics 會收集應用程式的使用和行為數據。SDK 主要會記錄兩種類型的資訊:

  • 事件:應用程式中發生的活動,例如使用者動作、系統事件或錯誤。
  • 使用者屬性:您定義的屬性,用來描述使用者族群區隔,例如語言偏好設定或地理位置。

Analytics 會自動記錄部分事件和使用者屬性,您不必新增任何程式碼即可啟用這些項目。如果應用程式需要收集其他資料,您最多可以設定 25 個不同的 Analytics 使用者屬性,並在應用程式中記錄最多 500 個不同的 Analytics 事件類型。應用程式記錄的事件總量沒有限制。

您可以在 Firebase 控制台的「Analytics」(數據分析) 頁面存取這項資料。

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

為協助您快速上手,Analytics SDK 定義了多種建議事件,這些事件在不同類型的應用程式中都很常見,包括零售和電子商務、旅遊和遊戲應用程式。如要進一步瞭解這些事件和使用時機,請參閱「建議事件」。如要在報表中取得最詳盡的資料,請記錄適合您應用程式的建議 Analytics 事件及其規定參數。這也能確保您在 Google Analytics 推出新功能時,能立即享有這些功能。

事前準備

使用 Google Analytics 前,請先完成下列事項:

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

    • 如果 Unity 專案已使用 Firebase,代表已註冊並設定 Firebase。

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

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

請注意,將 Firebase 新增至 Unity 專案時,您必須在 Firebase 控制台和開啟的 Unity 專案中執行工作 (例如從控制台下載 Firebase 設定檔,然後移至 Unity 專案)。

記錄事件

您可以立即開始使用 LogEvent() 方法記錄事件。

以下範例會記錄含有各種引數類型的事件:

// Log an event with no parameters.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(Firebase.Analytics.FirebaseAnalytics.EventLogin);

// Log an event with a float parameter
Firebase.Analytics.FirebaseAnalytics
  .LogEvent("progress", "percent", 0.4f);

// Log an event with an int parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventPostScore,
    Firebase.Analytics.FirebaseAnalytics.ParameterScore,
    42
  );

// Log an event with a string parameter.
Firebase.Analytics.FirebaseAnalytics
  .LogEvent(
    Firebase.Analytics.FirebaseAnalytics.EventJoinGroup,
    Firebase.Analytics.FirebaseAnalytics.ParameterGroupId,
    "spoon_welders"
  );

// Log an event with multiple parameters, passed as a struct:
Firebase.Analytics.Parameter[] LevelUpParameters = {
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterLevel, 5),
  new Firebase.Analytics.Parameter(
    Firebase.Analytics.FirebaseAnalytics.ParameterCharacter, "mrspoon"),
  new Firebase.Analytics.Parameter(
    "hit_accuracy", 3.14f)
};
Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventLevelUp,
  LevelUpParameters);

後續步驟