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

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

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

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

  • Предлагаемые мероприятия: просмотреть список 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 Event. Примеры включают доход, расстояние, время и баллы.

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

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

iOS +

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

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

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

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

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

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