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

Выберите платформу: iOS+ Android Веб Flutter Unity C++


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

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

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

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

Подготовка

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

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

  • Если вы используете имеющийся проект Firebase, в котором не включена Google Analytics, откройте Settings (Настройки) > Integrations (Интеграция) и включите ее.

Когда вы включаете в своем проекте 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:34.19.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.2.0")
}

  2. Вверху файла укажите объект com.google.firebase.analytics.FirebaseAnalytics:

    Kotlin 

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java 

    private FirebaseAnalytics mFirebaseAnalytics;

  3. Выполните инициализацию этого объекта в методе onCreate():

    Kotlin 

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

    Java 

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

Как начать регистрацию событий

После создания экземпляра 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")
}

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

Эта команда отображает ваши события в инструменте Logcat в Android Studio. Так вы сразу сможете проверить, отправляются ли события.

Дальнейшие действия