Как регистрировать события

Выберите платформу: iOS+ Android Веб Flutter Unity C++


С помощью событий можно отслеживать действия пользователей, системные события и ошибки в приложении.

Google Analytics автоматически регистрирует некоторые события, поэтому вам не нужно добавлять код, чтобы получать данные о них. Если вам нужно собирать дополнительные данные, вы можете регистрировать в приложении до 500 различных типов событий Analytics. Общее количество регистрируемых событий не ограничено. Обратите внимание, что в названиях событий учитывается регистр. Два события, названия которых отличаются только регистром, считаются разными.

Подготовка

Чтобы использовать Google Analytics, необходимо:

  • Зарегистрируйте проект Unity и настройте его для использования Firebase.

    • Если в проекте уже используется Firebase, можете пропустить этот шаг.

    • Если у вас нет проекта Unity, вы можете скачать пример приложения.

  • Добавьте в свой проект Unity Unity SDK для Firebase (в частности, FirebaseAnalytics.unitypackage).

Обратите внимание, что для добавления Firebase в проект Unity нужно выполнить действия как в консоли Firebase, так и в вашем открытом проекте Unity. Например, вам потребуется скачать файлы конфигурации Firebase из консоли, а затем переместить их в проект Unity.

Как регистрировать события

После инициализации модуля Firebase.Analytics.FirebaseAnalytics вы можете использовать его для регистрации событий с помощью метода LogEvent().

Чтобы вам было проще начать работу, в SDK Analytics определен ряд рекомендуемых событий, которые часто используются в приложениях разных типов, в том числе в приложениях для розничной и электронной торговли, путешествий и мобильных играх. Чтобы узнать больше об этих событиях и о том, когда их использовать, ознакомьтесь со статьями о рекомендуемых событиях в Справочном центре Google Аналитики.

Ниже указано, где можно найти подробную информацию об использовании рекомендуемых событий.

  • Рекомендуемые события: см. список констант 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);

Как посмотреть события в выходных данных журнала

iOS+

События регистрируются в консоли, и их можно просматривать во время работы приложения через XCode.

Android

Вы можете включить подробное ведение журнала отладки в Android Studio, чтобы убедиться, что события правильно регистрируются с помощью SDK. Это относится к событиям, регистрируемым как автоматически, так и вручную.

Вы можете включить ведение подробных журналов с помощью серии команд adb:

adb shell setprop log.tag.FA VERBOSE
 
adb shell setprop log.tag.FA-SVC VERBOSE
 
adb logcat -v time -s FA FA-SVC

Эта команда отображает ваши события в инструменте Logcat в Android Studio. Так вы сразу сможете проверить, отправляются ли события.

Как просматривать события аналитики на панели управления

В консоли Firebase можно посмотреть сводную статистику по событиям. Для этого перейдите в раздел Аналитика > События.

Обратите внимание на следующее:

  • На ней отображаются отчеты, которые создаются автоматически для каждого типа событий, зарегистрированных вашим приложением.

  • Она периодически обновляется в течение дня. Для оперативного тестирования используйте консоль отладки Xcode или выходные данные Logcat, как описано в предыдущем разделе.

Подробнее о панели…