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

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

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

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

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

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

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

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

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

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

Добавьте зависимость для библиотеки Android Google Analytics в файл Gradle вашего модуля (уровня приложения) (обычно app/build.gradle ):
Ява
```
implementation 'com.google.firebase:firebase-analytics:17.5.0'
```
Котлин + KTX
```
implementation 'com.google.firebase:firebase-analytics-ktx:17.5.0'
```
com.google.firebase.analytics.FirebaseAnalytics объект com.google.firebase.analytics.FirebaseAnalytics в верхней части своего действия:
Ява
```
private FirebaseAnalytics mFirebaseAnalytics;MainActivity.java
```
Котлин + KTX
```
private lateinit var firebaseAnalytics: FirebaseAnalyticsMainActivity.kt
```

Инициализируйте его в onCreate() :

Ява

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

Котлин + KTX

// Obtain the FirebaseAnalytics instance.
firebaseAnalytics = Firebase.analyticsMainActivity.kt

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

После того, как вы создали экземпляр 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);MainActivity.java

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

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