Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

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

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

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

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