Catch up on highlights from Firebase at Google I/O 2023. Learn more

開始使用 Google Analytics for Unity

Google Analytics 收集您應用程序的使用情況和行為數據。 SDK 記錄兩種主要類型的信息:

  • 事件:您的應用程序中發生的事情,例如用戶操作、系統事件或錯誤。
  • 用戶屬性:您定義的用於描述用戶群細分的屬性,例如語言偏好或地理位置。

Analytics 自動記錄一些事件用戶屬性;您無需添加任何代碼即可啟用它們。如果您的應用需要收集額外數據,您可以在您的應用中設置最多 25 個不同的 Analytics 用戶屬性並記錄最多 500 個不同的 Analytics 事件類型。您的應用記錄的事件總量沒有限制。

要訪問此數據:

  1. Firebase 控制台中,打開您的項目。
  2. 從菜單中選擇Analytics以查看 Analytics 報告儀表板。

事件選項卡顯示為您的應用程序記錄的每種不同類型的分析事件自動創建的事件報告。在 Firebase 幫助中心閱讀有關Analytics 報告儀表板的更多信息。

為幫助您入門,Analytics SDK 定義了一些建議事件,這些事件在不同類型的應用程序中很常見,包括零售和電子商務、旅遊和遊戲應用程序。要詳細了解這些事件以及何時使用它們,請瀏覽 Firebase 幫助中心中的事件和屬性文章。要在報告中獲取最詳細的信息,請記錄對您的應用及其規定參數有意義的建議 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);

下一步