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

iOS+ Android Vibração

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 ).

      • Você pode baixar o arquivo de configuração do Firebase Android novamente a qualquer momento.
      • Certifique-se de que o arquivo de configuração não contenha caracteres adicionais, como (2) .

   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
   MainActivity.kt

   Java

   private FirebaseAnalytics mFirebaseAnalytics;
   MainActivity.java

3. Inicialize-o no método onCreate() :

   Kotlin+KTX

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

   Java

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

Próximos passos

• Use o DebugView para verificar seus eventos.
• Explore seus dados no console do Firebase.
• Explore os guias sobre eventos e propriedades do usuário.
• Saiba como exportar seus dados para o BigQuery.