Начало работы с Google Аналитикой


Из этого краткого руководства вы узнаете, как добавить Google Analytics в свое приложение и начать регистрировать события.

Google Analytics собирает данные об использовании и поведении для вашего приложения. SDK регистрирует два основных типа информации:

  • События: что происходит в вашем приложении, например действия пользователя, системные события или ошибки.
  • Свойства пользователя: Атрибуты, которые вы определяете для описания сегментов вашей пользовательской базы, например языковые предпочтения или географическое положение.

Analytics автоматически регистрирует некоторые события и свойства пользователя ; вам не нужно добавлять какой-либо код, чтобы включить их.

Прежде чем начать

Если вы еще этого не сделали, добавьте Firebase в свой проект Android и убедитесь, что в вашем проекте Firebase включен Google Analytics :

  • Если вы создаете новый проект Firebase, включите Google Analytics во время процесса создания проекта.

  • Если вы используете существующий проект Firebase, в котором не включен Google Analytics , перейдите на вкладку «Интеграции» вашего > Настройки проекта , чтобы включить его.

Когда вы включаете Google Analytics в своем проекте, ваши приложения Firebase связываются с потоками данных Google Analytics .

Добавьте Analytics SDK в свое приложение

  1. В файле Gradle вашего модуля (уровня приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ) добавьте зависимость для библиотеки Analytics для Android. Мы рекомендуем использовать Firebase Android BoM для управления версиями библиотеки. 

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:33.16.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.

    (Альтернатива) Добавьте зависимости библиотеки 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.5.0")
}
     Ищете модуль библиотеки, специфичный для Kotlin? Начиная с октября 2023 года ( Firebase BoM 32.5.0) разработчики Kotlin и Java смогут полагаться на основной модуль библиотеки (подробности см. в разделе часто задаваемых вопросов об этой инициативе ).

  2. Объявите объект com.google.firebase.analytics.FirebaseAnalytics в верхней части вашей активности:

    Kotlin

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. Инициализируйте его в методе onCreate() :

    Kotlin

    // Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analytics
    MainActivity.kt

    Java

    // Obtain the FirebaseAnalytics instance.
mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
    MainActivity.java

Начать регистрацию событий

После создания экземпляра FirebaseAnalytics вы можете начать регистрировать события с помощью метода logEvent() .

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

Следующий код регистрирует событие 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")
}
MainActivity.kt

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);
MainActivity.java

Вы можете включить подробное ведение журнала для мониторинга регистрации событий 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, помогая вам немедленно проверить отправку событий.

Следующие шаги