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

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


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

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

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

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

Подготовка

Если вы ещё этого не сделали, добавьте Firebase в проект Android и убедитесь, что в нем включен 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:35.0.2"))

    // 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:24.0.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. Так вы сразу сможете проверить, отправляются ли события.

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