В этом кратком руководстве показано, как добавить Google Analytics в свое приложение и начать регистрировать события.
Google Analytics собирает данные об использовании и поведении вашего приложения. SDK регистрирует два основных типа информации:
- События. Что происходит в вашем приложении, например действия пользователя, системные события или ошибки.
- Свойства пользователя: атрибуты, которые вы определяете для описания сегментов вашей пользовательской базы, например языковые предпочтения или географическое местоположение.
Analytics автоматически регистрирует некоторые события и свойства пользователей ; вам не нужно добавлять какой-либо код, чтобы включить их.
Прежде чем начать
Если вы еще этого не сделали, добавьте Firebase в свой проект Android и убедитесь, что Google Analytics включен в вашем проекте Firebase:
Если вы создаете новый проект Firebase, включите Google Analytics во время рабочего процесса создания проекта.
Если вы используете существующий проект Firebase, в котором не включена Google Analytics , перейдите на вкладку «Интеграции» вашего
Когда вы включаете Google Analytics в своем проекте, ваши приложения Firebase связаны с потоками данных Google Analytics .
Добавьте Analytics SDK в свое приложение
В файле Gradle вашего модуля (на уровне приложения) (обычно
<project>/<app-module>/build.gradle.kts
или<project>/<app-module>/build.gradle
) добавьте зависимость для библиотеки Analytics . для Андроид. Мы рекомендуем использовать Firebase Android BoM для управления версиями библиотеки.dependencies { // Import the BoM for the Firebase platform implementation(platform("com.google.firebase:firebase-bom:33.4.0")) // Add the dependency for the Analytics library // When using the BoM, you don't specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-analytics") }
Используя Firebase Android BoM , ваше приложение всегда будет использовать совместимые версии библиотек Firebase Android.
Ищете библиотечный модуль, специфичный для Kotlin? Начиная с октября 2023 года ( Firebase BoM 32.5.0) от основного модуля библиотеки могут зависеть как разработчики Kotlin, так и Java (подробнее см. FAQ по этой инициативе ).(Альтернатива) Добавить зависимости библиотеки Firebase без использования BoM
Если вы решите не использовать Firebase BoM , вы должны указать каждую версию библиотеки Firebase в ее строке зависимости.
Обратите внимание: если вы используете в своем приложении несколько библиотек Firebase, мы настоятельно рекомендуем использовать BoM для управления версиями библиотек, что гарантирует совместимость всех версий.
dependencies { // Add the dependency for the Analytics library // When NOT using the BoM, you must specify versions in Firebase library dependencies implementation("com.google.firebase:firebase-analytics:22.1.2") }
Объявите объект
com.google.firebase.analytics.FirebaseAnalytics
в верхней части своей активности:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
Инициализируйте его в методе
onCreate()
:Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Начните регистрировать события
После того как вы создали экземпляр FirebaseAnalytics
, вы можете начать регистрировать события с помощью метода logEvent()
.
Определенные события рекомендуются для всех приложений ; другие рекомендуются для конкретных типов бизнеса или вертикалей. Вам следует отправлять предлагаемые события вместе с предписанными для них параметрами, чтобы обеспечить максимально подробную информацию в ваших отчетах и воспользоваться преимуществами будущих функций и интеграций по мере их появления. В этом разделе демонстрируется регистрация предварительно определенного события. Дополнительную информацию о регистрации событий см. в разделе Журнал событий .
Следующий код регистрирует событие 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);
Вы можете включить подробное ведение журнала, чтобы отслеживать регистрацию событий с помощью 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, помогая вам немедленно проверить отправку событий.
Следующие шаги
- Понимание каждого отчета Google Analytics .
- Используйте DebugView для проверки ваших событий.
- Изучите свои данные в консоли Firebase .
- Изучите руководства по событиям и свойствам пользователя.
- Узнайте, как экспортировать данные в BigQuery.