Catch up on everthing we announced at this year's Firebase Summit. Learn more

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

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

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

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

Прежде чем вы начнете

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

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

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

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

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

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

Джава

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

Котлин + KTX

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

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

  • Пользовательские параметры: Пользовательские параметры могут быть зарегистрированы для представления в отчетах Google Analytics. Они также могут быть использованы в качестве фильтров в аудитории определений , которые могут быть применены к каждому отчету. Пользовательские параметры также включены в данные экспортируются в BigQuery , если ваше приложение связано с проектом BigQuery.

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

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

Джава

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

Котлин + KTX

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

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

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

Джава

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

Котлин + KTX

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

firebaseAnalytics.setDefaultEventParameters(parameters)

Если параметр specificed в 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

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

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

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

Вы можете получить доступ к этой информации из событий приборной панели в консоли Firebase. На этой панели отображаются отчеты о событиях, которые автоматически создаются для каждого отдельного типа событий, регистрируемых вашим приложением.