Comece a usar o Google Analytics

Neste guia de início rápido, mostramos como adicionar Google Analytics ao seu app e começar a registrar eventos.

O Google Analytics coleta dados de uso e comportamento do seu app. O SDK registra dois tipos principais de informações:

• Eventos: o que acontece no seu app, como ações do usuário, eventos do sistema ou erros.
• Propriedades do usuário: atributos que você define para descrever segmentos da sua base de usuários, como preferência de idioma ou localização geográfica.

O Analytics registra automaticamente alguns eventos e propriedades do usuário. Não é preciso adicionar códigos para ativá-los.

Antes de começar

Adicione o Firebase ao seu projeto do Android, caso ainda não tenha feito isso, e verifique se o Google Analytics está ativado no seu projeto do Firebase:

• Se você estiver criando um novo projeto do Firebase, ative o Google Analytics durante a criação dele.

• Se você estiver usando um projeto do Firebase que não tenha o Google Analytics ativado, acesse a guia Integrações das suas settings > Configurações do projeto para ativá-lo.

Quando você ativa o Google Analytics no seu projeto, os apps do Firebase são vinculados aos fluxos de dados do Google Analytics.

Adicionar o SDK do Analytics ao seu app

1. 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. Recomendamos o uso do Firebase Android BoM para lidar com o controle de versões da biblioteca.

   dependencies {
       // Import the BoM for the Firebase platform
       implementation(platform("com.google.firebase:firebase-bom:34.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 o Firebase Android BoM, 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 o BoM

   Se você preferir não usar o Firebase BoM, especifique cada versão das bibliotecas do Firebase na linha de dependência correspondente.

   Se você usa várias bibliotecas do Firebase no app, recomendamos utilizar o 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:23.0.0")
   }

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

   Kotlin

   private lateinit var firebaseAnalytics: FirebaseAnalytics
   MainActivity.kt

   Java

   private FirebaseAnalytics mFirebaseAnalytics;
   MainActivity.java

3. Inicialize no método onCreate():

   Kotlin

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

   Java

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

Iniciar o registro de eventos

Depois de criar uma instância FirebaseAnalytics, comece a registrar eventos com o método logEvent().

Alguns eventos são recomendados para todos os apps, outros são indicados para tipos de negócios ou indústrias específicas. Você precisa enviar os eventos sugeridos junto com os parâmetros prescritos para garantir o máximo de detalhes nos relatórios e aproveitar os recursos e as integrações assim que forem disponibilizados. Nesta seção, demonstramos a geração de registros de um evento pré-definido. Para mais informações sobre a geração de registros de eventos, consulte Registrar eventos.

O código a seguir registra um evento SELECT_CONTENT quando um usuário clica em um elemento específico do seu app.

firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_ITEM) {
    param(FirebaseAnalytics.Param.ITEM_ID, id)
    param(FirebaseAnalytics.Param.ITEM_NAME, name)
    param(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
}
MainActivity.kt

Bundle bundle = new Bundle();
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id);
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name);
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image");
mFirebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle);
MainActivity.java

É possível ativar o registro detalhado para ver se o SDK está registrando adequadamente os eventos. Isso inclui os eventos registrados manual e automaticamente.

Ative o registro detalhado com uma série de comandos adb:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Esse comando exibe seus eventos no logcat do Android Studio, permitindo a verificação imediata do envio dos eventos.

Próximas etapas

• Entenda cada relatório do Google Analytics.
• 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.