Usar o Google Analytics para ver métricas de relatórios de erros

O Google Analytics é o mecanismo de análise do Firebase. Ao usar o Analytics e o Crashlytics juntos no seu app, você recebe recursos que ajudam a produzir problemas e monitoram os dados de falha com mais granularidade, como usuários sem falhas e navegações estruturais que rastreiam eventos específicos antes de uma falha. Além disso, você também recebe acesso ao BigQuery, que mostra as principais métricas do seu app.

Veja neste guia como adicionar o Analytics a um app que tenha o Crashlytics configurado (não se esqueça de adicionar o Crashlytics ao seu app).

Etapa 1: adicionar um arquivo de configuração do Firebase

  1. Para adicionar o arquivo de configuração do Firebase para Android ao app, siga estas etapas:

    1. Abra suas Configurações do projeto. No cartão Seus apps, selecione o nome do pacote do app que precisa de um arquivo de configuração.

    2. Clique em Fazer o download do google-services.json para receber o arquivo de configuração do Firebase para Android (google-services.json).

    3. Mova seu arquivo de configuração para o diretório de módulos do seu app.

  2. Para ativar os produtos do Firebase no seu app, adicione o plug-in google-services aos seus arquivos do Gradle.

    1. No arquivo do Gradle no nível raiz (nível do projeto) (<project>/build.gradle.kts ou <project>/build.gradle), adicione regras para incluir o plug-in do Gradle para Serviços do Google. Verifique se você tem o repositório Maven do Google também.

      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. No arquivo do Gradle módulo (nível do app) (gedralmente <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle), aplique o plug-in Google Services para Gradle.

      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'
         // ...
      }
      

Etapa 2: adicionar o SDK do Analytics ao seu app

  1. No arquivo Gradle do módulo (nível do app) (geralmente <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle), adicione a dependência da biblioteca do Analytics para Android. Para gerenciar o controle de versões das bibliotecas, recomendamos usar a BoM do Firebase para Android.

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

    Com a BoM do Firebase para Android, seu app sempre vai usar versões compatíveis das bibliotecas do Firebase para Android.

    (Alternativa) Adicionar dependências das bibliotecas do Firebase sem usar a BoM

    Se você preferir não usar a BoM do Firebase, especifique cada versão das bibliotecas do Firebase na linha de dependência correspondente.

    Se você usa várias bibliotecas do Firebase no seu app, recomendamos utilizar a BoM para gerenciar as versões delas, porque isso ajuda a garantir a compatibilidade de todas as bibliotecas.

    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'
    }
    
    Está procurando um módulo de biblioteca específico do Kotlin? A partir de outubro de 2023 (BoM do Firebase 32.5.0), os desenvolvedores Kotlin e Java poderão depender do módulo da biblioteca principal. Para mais detalhes, consulte Perguntas frequentes sobre essa iniciativa).

  2. Declare o objeto com.google.firebase.analytics.FirebaseAnalytics na parte de cima da sua atividade:

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

    private FirebaseAnalytics mFirebaseAnalytics;
  3. Inicialize no método onCreate():

    Kotlin+KTX

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

    Java

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

Próximas etapas