Catch up on highlights from Firebase at Google I/O 2023. Learn more

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

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

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

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

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

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

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

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

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

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

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

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

    Kotlin+KTX

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

    Используя 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-ktx:21.3.0'
    }
    

    Java

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

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

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

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

    Kotlin+KTX

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

    Java

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

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

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

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

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

Kotlin+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")
}

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

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

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