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

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

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

В этом руководстве показано, как регистрировать события в вашем приложении.

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

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

Прежде чем вы начнете

Убедитесь, что вы настроили свой проект и можете получить доступ к Analytics, как описано в разделе Начало работы с Analytics .

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

После того, как вы создали экземпляр FirebaseAnalytics , вы можете использовать его для регистрации событий с помощью logEvent() .

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

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

В следующем примере показано, как зарегистрировать событие SELECT_CONTENT :

Java

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);

Kotlin+KTX

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}

Помимо прописанных параметров, вы можете добавить к любому событию следующие параметры:

  • Специальные параметры. Специальные параметры можно использовать в качестве параметров или показателей в отчетах Google Analytics . Вы можете использовать специальные параметры для нечисловых данных параметров событий и специальные показатели для любых данных параметров, которые лучше представлены в числовом виде. Зарегистрировав настраиваемый параметр с помощью SDK, зарегистрируйте параметр или показатель, чтобы эти настраиваемые параметры отображались в отчетах Analytics. Для этого выполните следующие действия: Аналитика > События > Управление пользовательскими определениями > Создать пользовательские параметры .

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

  • Параметр VALUE : VALUE — это параметр общего назначения, который полезен для накопления ключевой метрики, относящейся к событию. Примеры включают доход, расстояние, время и баллы.

Если у вашего приложения есть особые потребности, которые не покрываются рекомендуемым типом события, вы можете регистрировать свои собственные пользовательские события, как показано в этом примере:

Java

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Kotlin+KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}

Установить параметры события по умолчанию

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

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

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

Kotlin+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Если параметр указан в logEvent() , вместо значения по умолчанию используется это значение.

Чтобы очистить параметр по умолчанию, вызовите метод setDefaultEventParameters с параметром, установленным на null .

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

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

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

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