Журнал событий

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

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

Прежде чем начать

Прежде чем использовать Google Analytics , вам необходимо:

Зарегистрируйте свой проект Unity и настройте его для использования Firebase.
- Если ваш проект Unity уже использует Firebase, значит, он уже зарегистрирован и настроен для Firebase.
- Если у вас нет проекта Unity, вы можете загрузить пример приложения .
Добавьте Firebase Unity SDK (в частности, FirebaseAnalytics.unitypackage ) в свой проект Unity.

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

Журнал событий

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

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

Подробную информацию о реализации рекомендуемых событий можно найти в следующих местах:

Предлагаемые события: см. список констант 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);

Просмотр событий в журнале вывода

Андроид

Вы можете включить подробное ведение журнала в журнале отладки 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, помогая вам немедленно проверить отправку событий.

iOS+

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

Просмотр аналитических событий на панели управления

Вы можете просматривать агрегированную статистику по событиям Analytics на панелях управления консоли Firebase . Эти панели периодически обновляются в течение дня. Для немедленного тестирования используйте вывод LogCat, как описано в предыдущем разделе.

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

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

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