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

Выберите платформу: 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 выберите Аналитика > Специальные определения.

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

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