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
Para adicionar o arquivo de configuração do Firebase para Android ao app, siga estas etapas:
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.
Clique em Fazer o download do google-services.json para receber o arquivo de configuração do Firebase para Android (
google-services.json
).- É possível fazer o download do arquivo de configuração do Firebase para Android novamente a qualquer momento.
- Verifique se não há caracteres adicionais no arquivo de configuração, como
(2)
.
Mova seu arquivo de configuração para o diretório de módulos do seu app.
Para ativar os produtos do Firebase no seu app, adicione o plug-in google-services aos seus arquivos do Gradle.
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 }
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
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' }
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;
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
- Use o DebugView para verificar seus eventos.
- Confira seus dados no Console do Firebase.
- Conheça os guias sobre eventos e propriedades do usuário.
- Saiba como exportar seus dados para o BigQuery.