Catch up on everthing we announced at this year's Firebase Summit. Learn more

Начать работу с Google Analytics

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

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

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

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

Прежде чем вы начнете

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

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

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

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

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

  1. Использование Firebase Android Банка Москвы , объявить зависимость для библиотеки Analytics Android в вашем модуле (приложение уровня) Gradle файл (обычно app/build.gradle ).

    Джава

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:29.0.0')
    
        // Declare 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 Банка Москвы , ваше приложение будет всегда использовать совместимые версии библиотек Firebase Android.

    (Альтернативный) Объявляет Firebase библиотеки зависимостей без использования спецификации

    Если вы решите не использовать Firebase BoM, вы должны указать каждую версию библиотеки Firebase в ее строке зависимости.

    Обратите внимание , что если вы используете несколько библиотеки Firebase в вашем приложении, мы настоятельно рекомендуем использовать спецификации для управления версиями библиотеки, что гарантирует , что все версии совместимы.

    dependencies {
        // Declare 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:20.0.0'
    }
    

    Котлин + KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:29.0.0')
    
        // Declare 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-ktx'
    }
    

    С помощью Firebase Android Банка Москвы , ваше приложение будет всегда использовать совместимые версии библиотек Firebase Android.

    (Альтернативный) Объявляет Firebase библиотеки зависимостей без использования спецификации

    Если вы решите не использовать Firebase BoM, вы должны указать каждую версию библиотеки Firebase в ее строке зависимости.

    Обратите внимание , что если вы используете несколько библиотеки Firebase в вашем приложении, мы настоятельно рекомендуем использовать спецификации для управления версиями библиотеки, что гарантирует , что все версии совместимы.

    dependencies {
        // Declare 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-ktx:20.0.0'
    }
    

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

    Джава

    private FirebaseAnalytics mFirebaseAnalytics;

    Котлин + KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. Инициализировать его в onCreate() метод:

    Джава

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

    Котлин + KTX

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

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

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

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

Следующий код регистрирует SELECT_CONTENT событие , когда пользователь нажимает на определенный элемент в вашем приложении.

Джава

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);

Котлин + 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")
}

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

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