Unity 版 Google Analytics 使用入门

Google Analytics 会收集您的应用的使用情况和行为数据。SDK 会记录两种主要类型的信息：

  • 事件：您的应用中发生了什么，例如用户操作、系统事件或错误。
  • 用户属性：您为描述自己的各个细分用户群而定义的特性，例如语言首选项或地理位置。

Analytics 会自动记录某些事件和用户属性；您无需为此添加任何代码。如果您的应用需要收集额外的数据，您可以在应用中设置多达 25 种不同的 Analytics 用户属性，并记录多达 500 种不同的 Analytics 事件类型。您的应用记录的事件总数没有限制。

要访问此数据，请执行以下操作：

  1. 在 Firebase 控制台中，打开您的项目。
  2. 从菜单中选择 Analytics 以查看 Analytics 报告信息中心。

事件标签页会显示事件报告，这些报告是针对应用所记录的每种独特的 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);

后续步骤