В этой статье описано, как отправлять данные о событиях из приложения в Аналитику с помощью SDK Google Аналитики для Firebase. О том, как отправлять данные о событиях с сайтов, можно узнать из этой статьи. Подробнее о событиях…
Подготовка
Убедитесь, что у вас настроен проект и есть доступ к Аналитике, как описано в статье Начало работы с Google Аналитикой.
Как отправлять события
Настроив экземпляр FirebaseApp
, вы можете начать отправку событий с помощью метода logEvent()
. Этот метод работает аналогично команде event в gtag.js.
В примере ниже показано, как отправлять рекомендуемое событие 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
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
param(FirebaseAnalytics.Param.ITEM_ID, id)
param(FirebaseAnalytics.Param.ITEM_NAME, name)
param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
Помимо предписанных параметров, вы можете добавить к любому событию следующие:
- Специальные параметры, которые могут использоваться в качестве параметров и показателей в отчетах Аналитики. Вы можете использовать специальные параметры для нечисловых данных по параметрам событий, а специальные показатели – для данных по параметрам, которые удобнее представлять в числовом виде. После того как вы зарегистрируете специальный параметр с помощью SDK, чтобы он отображался в отчетах Аналитики, вам нужно зарегистрировать соответствующий ему параметр или показатель. Сделать это можно в меню Аналитика > События > Настроить пользовательские определения > Создать специальный параметр.
- Параметр общего назначения
VALUE
, удобный для сбора данных по ключевому показателю, относящемуся к событию. Примеры: доход, расстояние, время и баллы.
Если предлагаемые типы событий не подходят для вашего приложения, вы можете регистрировать собственные специальные события, как показано в примере ниже:
Java
Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);
Kotlin
firebaseAnalytics.logEvent("share_image") {
param("image_name", name)
param("full_text", text)
}
Как настроить параметры по умолчанию для событий
Вы можете регистрировать параметры различных событий с помощью setDefaultEventParameters
. Параметры по умолчанию связаны со всеми событиями, которые будут регистрироваться в будущем.
Зарегистрируйте параметры по умолчанию для событий, чтобы соответствующие им специальные параметры отображались в отчетах Аналитики.
Java
Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);
Kotlin
val parameters = Bundle().apply {
this.putString("level_name", "Caverns01")
this.putInt("level_difficulty", 4)
}
firebaseAnalytics.setDefaultEventParameters(parameters)
Если в методе logEvent()
указан параметр, вместо значения по умолчанию используется его значение.
Чтобы удалить значение параметра по умолчанию, вызовите метод setDefaultEventParameters
, задав для параметра значение nil
.
Как просматривать события в журнале отладки 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, как описано в предыдущем разделе.
Эти данные доступны на панели управления Events (События) в консоли Firebase, где отображаются отчеты, которые создаются автоматически для каждого типа событий, зарегистрированных вашим приложением.