Используйте Google Analytics для получения показателей для отчетов о сбоях

Google Analytics — это аналитическая система Firebase. Когда вы вместе используете Analytics и Crashlytics в своем приложении, вы получаете функции, которые помогут вам создавать проблемы и отслеживать данные о сбоях с большей степенью детализации, например, пользователи, у которых не было сбоев, хлебные крошки, которые отслеживают определенные события перед сбоем, и BigQuery, где вы можете визуализировать ключевые показатели вашего приложения.

В этом руководстве описывается, как добавить Analytics в приложение, в котором настроен Crashlytics (если вы еще этого не сделали, добавьте Crashlytics в свое приложение ).

Шаг 1. Добавьте файл конфигурации Firebase

  1. Добавьте файл конфигурации Firebase Android в свое приложение:

    1. Откройте настройки проекта. На карточке Ваши приложения выберите имя пакета приложения, для которого вам нужен файл конфигурации.

    2. Нажмите «Загрузить google-services.json» , чтобы получить файл конфигурации Firebase Android ( google-services.json ).

      • Вы можете снова загрузить файл конфигурации Firebase Android в любое время.
      • Убедитесь, что к файлу конфигурации не добавлены дополнительные символы, например (2) .

    3. Переместите файл конфигурации в каталог модуля (на уровне приложения) вашего приложения.

  2. Чтобы включить продукты Firebase в своем приложении, добавьте плагин google-services в файлы Gradle.

    1. В файле Gradle корневого уровня (уровня проекта) ( <project>/build.gradle.kts или <project>/build.gradle ) добавьте правила для включения плагина Gradle сервисов Google. Убедитесь, что у вас также есть репозиторий Google Maven.

      Kotlin

      plugins {
   id("com.android.application") version "7.3.0" apply false
   // ...

   // Add the dependency for the Google services Gradle plugin
   id("com.google.gms.google-services") version "4.4.0" apply false
}

      Groovy

      plugins {
   id 'com.android.application' version '7.3.0' apply false
   // ...

   // Add the dependency for the Google services Gradle plugin
   id 'com.google.gms.google-services' version '4.4.0' apply false
}

    2. В файле Gradle вашего модуля (на уровне приложения) (обычно <project>/<app-module>/build.gradle.kts или <project>/<app-module>/build.gradle ) примените плагин Gradle сервисов Google.

      Kotlin

      plugins {
   id("com.android.application")

   // Add the Google services Gradle plugin
   id("com.google.gms.google-services")
   // ...
}

      Groovy

      plugins {
   id 'com.android.application'

   // Add the Google services Gradle plugin
   id 'com.google.gms.google-services'
   // ...
}

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

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

    dependencies {
    // Import the BoM for the Firebase platform
    implementation(platform("com.google.firebase:firebase-bom:32.7.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, вы должны указать каждую версию библиотеки 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.5.0'
}
    Ищете библиотечный модуль, специфичный для Kotlin? Начиная с октября 2023 года (Firebase BoM 32.5.0) от основного модуля библиотеки могут зависеть как разработчики Kotlin, так и Java (подробнее см. FAQ по этой инициативе ).

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

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

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

    Kotlin+KTX

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

    Java

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

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