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

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

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

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

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

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

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

• При создании нового проекта Firebase включите Google Analytics в процессе создания проекта.

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

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

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

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:34.7.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:23.0.0")
   }

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 , когда пользователь щелкает по определенному элементу в вашем приложении.

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

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