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

Начните работу с Google Analytics для Unity

Google Analytics собирает данные об использовании и поведении вашего приложения. SDK регистрирует два основных типа информации:

  • События: что происходит в вашем приложении, например действия пользователя, системные события или ошибки.
  • Свойства пользователя. Атрибуты, которые вы определяете для описания сегментов вашей пользовательской базы, такие как языковые предпочтения или географическое положение.

Analytics автоматически регистрирует некоторые события и свойства пользователя ; вам не нужно добавлять какой-либо код, чтобы включить их. Если вашему приложению необходимо собирать дополнительные данные, вы можете настроить до 25 различных пользовательских свойств Google Analytics и зарегистрировать в своем приложении до 500 различных типов событий Analytics. Нет ограничений на общий объем событий, регистрируемых вашим приложением.

Чтобы получить доступ к этим данным:

  1. В консоли Firebase откройте свой проект.
  2. Выберите Analytics в меню, чтобы просмотреть панель отчетов Analytics.

На вкладке «События» отображаются отчеты о событиях , которые автоматически создаются для каждого отдельного типа события Analytics, зарегистрированного вашим приложением. Узнайте больше о панели управления отчетами Analytics в Справочном центре Firebase.

Чтобы помочь вам начать работу, 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);

Следующие шаги