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 (
build.gradle
) no nível raiz (nível do projeto), adicione regras para incluir o plug-in Google Services para Gradle. Verifique se você tem o repositório Maven do Google também.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 // ... } }
No arquivo do Gradle (geralmente
app/build.gradle
) do módulo (nível do app), aplique o plug-in Google Services para Gradle.apply plugin: 'com.android.application' // Add the following line: apply plugin: 'com.google.gms.google-services' // Google Services plugin android { // ... }
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
), adicione a dependência da biblioteca Android do Analytics. Para gerenciar o controle de versões das bibliotecas, recomendamos usar a BoM do Firebase para Android.Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:32.1.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' }
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-ktx:21.3.0' }
Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:32.1.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.3.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.