Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Use o Google Analytics para obter métricas para relatórios de falhas

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

O Google Analytics é o mecanismo de análise do Firebase. Ao usar Analytics e Crashlytics juntos em seu aplicativo, você obtém recursos que ajudam a produzir problemas e acompanhar os dados de falhas com mais granularidade, como usuários sem falhas, breadcrumbs que rastreiam eventos específicos antes de uma falha e BigQuery, onde você pode visualizar as principais métricas do seu aplicativo.

Este guia descreve como adicionar o Analytics a um aplicativo com o Crashlytics configurado (se ainda não o fez, adicione o Crashlytics ao seu aplicativo ).

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

  1. Adicione o arquivo de configuração Firebase Android ao seu aplicativo:

    1. Abra as configurações do seu projeto. No cartão Seus aplicativos , selecione o nome do pacote do aplicativo para o qual você precisa de um arquivo de configuração.

    2. Clique em Baixar google-services.json para obter seu arquivo de configuração do Firebase Android ( google-services.json ).

    3. Mova seu arquivo de configuração para o diretório do módulo (nível do aplicativo) do seu aplicativo.

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

    1. No arquivo Gradle de nível raiz (nível de projeto) ( build.gradle ), adicione regras para incluir o plug-in Gradle do Google Services. Verifique se você também possui o repositório Maven do Google.

      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.15'  // Google Services plugin
        }
      }
      
      allprojects {
        // ...
      
        repositories {
          // Check that you have the following line (if not, add it):
          google()  // Google's Maven repository
          // ...
        }
      }
      
    2. No arquivo Gradle do módulo (nível do aplicativo) (geralmente app/build.gradle ), aplique o plug-in Gradle do Google Services.

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

Etapa 2: adicionar o Analytics SDK ao seu aplicativo

  1. No arquivo Gradle do módulo (nível do aplicativo) (geralmente <project>/<app-module>/build.gradle ), adicione a dependência para a biblioteca Analytics Android. Recomendamos usar o Firebase Android BoM para controlar o controle de versão da biblioteca.

    Kotlin+KTX

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

    Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.

    (Alternativa) Adicionar dependências da biblioteca Firebase sem usar o BoM

    Se você optar por não usar o Firebase BoM, deverá especificar cada versão da biblioteca Firebase em sua linha de dependência.

    Observe que, se você usar várias bibliotecas do Firebase em seu aplicativo, recomendamos usar o BoM para gerenciar as versões da biblioteca, o que garante que todas as versões sejam compatíveis.

    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-ktx:21.2.0'
    }
    

    Java

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

    Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.

    (Alternativa) Adicionar dependências da biblioteca Firebase sem usar o BoM

    Se você optar por não usar o Firebase BoM, deverá especificar cada versão da biblioteca Firebase em sua linha de dependência.

    Observe que, se você usar várias bibliotecas do Firebase em seu aplicativo, recomendamos usar o BoM para gerenciar as versões da biblioteca, o que garante que todas as versões sejam compatíveis.

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

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

    Kotlin+KTX

    private lateinit var firebaseAnalytics: FirebaseAnalytics

    Java

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

    Kotlin+KTX

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

    Java

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

Próximos passos