В этом руководстве показано, как регистрировать события в вашем приложении.
События дают представление о том, что происходит в вашем приложении, например о действиях пользователя, системных событиях или ошибках.
Analytics автоматически регистрирует для вас некоторые события ; вам не нужно добавлять какой-либо код для их получения. Если вашему приложению необходимо собирать дополнительные данные, вы можете зарегистрировать в своем приложении до 500 различных типов событий Analytics . Общий объем событий, регистрируемых вашим приложением, не ограничен. Обратите внимание, что имена событий чувствительны к регистру и что регистрация двух событий, имена которых различаются только по регистру, приводит к двум различным событиям.
Прежде чем начать
Убедитесь, что вы настроили свой проект и можете получить доступ к Analytics , как описано в разделе «Начало работы с Analytics .
Журнал событий
После того как вы создали экземпляр FirebaseAnalytics
, вы можете использовать его для регистрации событий с помощью метода logEvent()
.
Чтобы помочь вам начать работу, Analytics SDK определяет ряд рекомендуемых событий, которые являются общими для различных типов приложений, включая приложения для розничной торговли и электронной коммерции, путешествий и игр. Дополнительные сведения об этих событиях и о том, когда их использовать, см. в разделе Рекомендуемые события .
Подробности реализации рекомендуемых типов событий можно найти в следующих местах:
- Рекомендуемые события: см. справочник по классу
com.google.firebase.analytics.FirebaseAnalytics.Event
. - Предписанные параметры: см. ссылку
com.google.firebase.analytics.FirebaseAnalytics.Param
.
В следующем примере показано, как зарегистрировать событие SELECT_CONTENT
:
Kotlin+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") }
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, зарегистрируйте параметр или показатель, чтобы эти специальные параметры отображались в отчетах Analytics. Сделайте это, используя «Аналитика» > «События» > «Управление пользовательскими определениями» > «Создать специальные измерения».
Пользовательские параметры можно использовать в определениях аудитории , которые можно применять к каждому отчету. Пользовательские параметры также включаются в данные , экспортируемые в BigQuery, если ваше приложение связано с проектом BigQuery. Найдите примеры запросов и многое другое в Google Analytics 4 BigQuery Export .
Параметр
VALUE
:VALUE
— это параметр общего назначения, который полезен для сбора ключевого показателя, относящегося к событию. Примеры включают доход, расстояние, время и баллы.
Если у вашего приложения есть особые потребности, не удовлетворяемые рекомендуемым типом событий, вы можете регистрировать свои собственные события, как показано в этом примере:
Kotlin+KTX
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
. Параметры по умолчанию связаны со всеми будущими событиями, которые регистрируются.
Как и в случае с пользовательскими параметрами, зарегистрируйте параметры событий по умолчанию, чтобы они отображались в отчетах Analytics.
Kotlin+KTX
val parameters = Bundle().apply { this.putString("level_name", "Caverns01") this.putInt("level_difficulty", 4) } firebaseAnalytics.setDefaultEventParameters(parameters)
Java
Bundle parameters = new Bundle(); params.putString("level_name", "Caverns01"); params.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
Эта команда отображает ваши события в лог-коде Android Studio, помогая вам немедленно проверить отправку событий.
Просматривайте события в панели управления
Вы можете просмотреть агрегированную статистику о ваших событиях на панелях консоли Firebase . Эти информационные панели периодически обновляются в течение дня. Для немедленного тестирования используйте вывод logcat, как описано в предыдущем разделе.
Вы можете получить доступ к этим данным на панели инструментов «События» в консоли Firebase . На этой панели мониторинга отображаются отчеты о событиях, которые автоматически создаются для каждого отдельного типа событий, регистрируемых вашим приложением.