Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

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

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

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

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

iOS+

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

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

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

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

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

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