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

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

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

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

Прежде чем начать

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

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

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

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

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

Рекомендуемые события: см. справочник по классу com.google.firebase.analytics.FirebaseAnalytics.Event .
Предписанные параметры: см. справочник com.google.firebase.analytics.FirebaseAnalytics.Param .

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

Kotlin

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

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);MainActivity.java

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

Пользовательские параметры: пользовательские параметры можно использовать в качестве измерений или метрик в отчётах Analytics . Вы можете использовать пользовательские измерения для нечисловых данных параметров событий, а пользовательские метрики — для любых данных параметров, которые лучше представить в числовом виде. После регистрации пользовательского параметра с помощью SDK зарегистрируйте измерение или метрику, чтобы эти пользовательские параметры отображались в отчётах Analytics. Для этого выберите «Аналитика» > «События» > «Управление пользовательскими определениями» > «Создать пользовательские измерения».
Пользовательские параметры можно использовать в определениях аудитории , которые можно применять к каждому отчёту. Пользовательские параметры также включаются в данные , экспортируемые в BigQuery, если ваше приложение связано с проектом BigQuery. Примеры запросов и многое другое можно найти в разделе Google Analytics 4 BigQuery Export .
Параметр VALUE : VALUE — это параметр общего назначения, полезный для сбора ключевых показателей, относящихся к событию. Примеры включают доход, расстояние, время и баллы.

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

Kotlin

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

Java

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

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

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

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

Kotlin

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Java

Bundle parameters = new Bundle();
parameters.putString("level_name", "Caverns01");
parameters.putInt("level_difficulty", 4);
mFirebaseAnalytics.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

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

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

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

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