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


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

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

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

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

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

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

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

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

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

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

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

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