В этом кратком руководстве показано, как добавить Google Analytics в свое приложение и начать регистрацию событий.
Google Analytics собирает данные об использовании и поведении вашего приложения. SDK регистрирует два основных типа информации:
- События: что происходит в вашем приложении, например действия пользователя, системные события или ошибки.
- Свойства пользователя. Атрибуты, которые вы определяете для описания сегментов вашей пользовательской базы, такие как языковые предпочтения или географическое положение.
Analytics автоматически регистрирует некоторые события и свойства пользователя ; вам не нужно добавлять какой-либо код, чтобы включить их.
Прежде чем вы начнете
Если вы еще этого не сделали, добавьте Firebase в свой проект Android и убедитесь, что Google Analytics включен в вашем проекте Firebase:
Если вы создаете новый проект Firebase, включите Google Analytics во время рабочего процесса создания проекта.
Если вы используете существующий проект Firebase, в котором не включен Google Analytics, перейдите на вкладку « Интеграция » в > Настройки проекта, чтобы включить его.
Когда вы включаете Google Analytics в своем проекте, ваши приложения Firebase связываются с потоками данных Google Analytics.
Добавьте Analytics SDK в свое приложение
В файл 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:31.2.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.2.0' }Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.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.2.0' }Объявите объект
com.google.firebase.analytics.FirebaseAnalyticsвверху вашей активности:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
Инициализируйте его в
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, помогая вам сразу убедиться, что события отправляются.
Следующие шаги
- Используйте DebugView для проверки событий.
- Исследуйте свои данные в консоли Firebase.
- Изучите руководства по событиям и свойствам пользователей.
- Узнайте, как экспортировать данные в BigQuery.
В этом кратком руководстве показано, как добавить Google Analytics в свое приложение и начать регистрацию событий.
Google Analytics собирает данные об использовании и поведении вашего приложения. SDK регистрирует два основных типа информации:
- События: что происходит в вашем приложении, например действия пользователя, системные события или ошибки.
- Свойства пользователя. Атрибуты, которые вы определяете для описания сегментов вашей пользовательской базы, такие как языковые предпочтения или географическое положение.
Analytics автоматически регистрирует некоторые события и свойства пользователя ; вам не нужно добавлять какой-либо код, чтобы включить их.
Прежде чем вы начнете
Если вы еще этого не сделали, добавьте Firebase в свой проект Android и убедитесь, что Google Analytics включен в вашем проекте Firebase:
Если вы создаете новый проект Firebase, включите Google Analytics во время рабочего процесса создания проекта.
Если вы используете существующий проект Firebase, в котором не включен Google Analytics, перейдите на вкладку « Интеграция » в > Настройки проекта, чтобы включить его.
Когда вы включаете Google Analytics в своем проекте, ваши приложения Firebase связываются с потоками данных Google Analytics.
Добавьте Analytics SDK в свое приложение
В файл 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:31.2.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.2.0' }Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:31.2.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.2.0' }Объявите объект
com.google.firebase.analytics.FirebaseAnalyticsвверху вашей активности:Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Java
private FirebaseAnalytics mFirebaseAnalytics;
Инициализируйте его в
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, помогая вам сразу убедиться, что события отправляются.
Следующие шаги
- Используйте DebugView для проверки событий.
- Исследуйте свои данные в консоли Firebase.
- Изучите руководства по событиям и свойствам пользователей.
- Узнайте, как экспортировать данные в BigQuery.