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

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


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

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

Подготовка

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

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

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

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

  • Добавьте в свой проект Unity Firebase Unity SDK (в частности, 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, как описано в предыдущем разделе этого руководства.

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