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 possibilita a visualização das 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.13' // 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
Usando a BoM do Firebase para Android, declare a dependência da biblioteca Android do Analytics no seu arquivo do Gradle (nível do app) do módulo, que geralmente é
app/build.gradle
.Java
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.3.1') // Declare 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 usará versões compatíveis das bibliotecas do Firebase para Android.
(Alternativa) Declare as 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.
Caso você use várias bibliotecas do Firebase no seu app, recomendamos usar a BoM para gerenciar as versões dessas bibliotecas para garantir a compatibilidade de todas elas.
dependencies { // Declare 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.1.0' }
Kotlin+KTX
dependencies { // Import the BoM for the Firebase platform implementation platform('com.google.firebase:firebase-bom:30.3.1') // Declare 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 usará versões compatíveis das bibliotecas do Firebase para Android.
(Alternativa) Declare as 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.
Caso você use várias bibliotecas do Firebase no seu app, recomendamos usar a BoM para gerenciar as versões dessas bibliotecas para garantir a compatibilidade de todas elas.
dependencies { // Declare 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.1.0' }
Declare o objeto
com.google.firebase.analytics.FirebaseAnalytics
na parte superior da sua atividade:Java
private FirebaseAnalytics mFirebaseAnalytics;
Kotlin+KTX
private lateinit var firebaseAnalytics: FirebaseAnalytics
Inicialize no método
onCreate()
:Java
// Obtain the FirebaseAnalytics instance. mFirebaseAnalytics = FirebaseAnalytics.getInstance(this);
Kotlin+KTX
// Obtain the FirebaseAnalytics instance. firebaseAnalytics = Firebase.analytics
Próximas etapas
- Use o DebugView para verificar seus eventos.
- Explore 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.