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

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

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() .

Чтобы помочь вам начать работу, SDK Analytics определяет ряд рекомендуемых событий, общих для различных типов приложений, включая приложения для розничной торговли и электронной коммерции, путешествий и игр. Чтобы узнать больше об этих событиях и о том, когда их использовать, см. статьи о рекомендуемых событиях в Справочном центре 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

В отладочном журнале 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 :

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

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