Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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 справочного центре.