Используйте 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 корневого уровня (уровня проекта) ( build.gradle ) добавьте правила для включения подключаемого модуля Google Services Gradle. Убедитесь, что у вас также есть репозиторий Google Maven.

      buildscript {
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
        }
      
        dependencies {
          // ...
      
          // Add the following line:
          classpath 'com.google.gms:google-services:4.3.12'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. В файле Gradle вашего модуля (уровня приложения) (обычно app/build.gradle ) примените плагин Google Services Gradle.

      apply plugin: 'com.android.application'
      // Add the following line:
      apply plugin: 'com.google.gms.google-services'  // Google Services plugin
      
      android {
        // ...
      }
      

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

  1. Используя Firebase Android BoM , объявите зависимость для библиотеки Analytics Android в файле Gradle вашего модуля (на уровне приложения) (обычно app/build.gradle ).

    Java

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

    Kotlin+KTX

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

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

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. Инициализируйте его в onCreate() :

    Java

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

    Kotlin+KTX

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

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