Как регистрировать события

Выберите платформу: iOS+ Android Веб Flutter Unity C++


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

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")
}

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);

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

  • Специальные параметры, которые могут использоваться в качестве параметров и показателей в отчетах Analytics. Вы можете использовать специальные параметры для нечисловых данных по параметрам событий, а специальные показатели – для данных по параметрам, которые удобнее представлять в числовом виде. После того как вы зарегистрируете специальный параметр с помощью SDK, чтобы он отображался в отчетах Аналитики, вам нужно зарегистрировать соответствующий ему параметр или показатель. Для этого в консоли Firebase выберите Analytics (Аналитика) > Custom Definitions (Специальные определения).

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

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

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

Kotlin 

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

Java 

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

Как настроить параметры по умолчанию для событий

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

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

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, как описано в предыдущем разделе.