Google is committed to advancing racial equity for Black communities. See how.
Эта страница была переведа с помощью Cloud Translation API.
Switch to English

Начать работу с 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 в свое приложение

  1. Добавьте зависимость для библиотеки 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'
    
  2. com.google.firebase.analytics.FirebaseAnalytics объект 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, помогая вам сразу проверить отправку событий.

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