Primeiros passos do Google Analytics no Android

O Google Analytics coleta dados de uso e de comportamento para 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 é necessário adicionar códigos para ativá-los.

Antes de começar

Se você estiver criando um novo projeto, adicione o Firebase ao seu projeto Android e siga as etapas para configurar o Google Analytics no projeto durante a criação dele.

Se você tem um projeto atual e não configurou o Google Analytics, é possível vincular o Google Analytics ao seu projeto na guia Integrações em settings > Configurações do projeto.

Adicionar o Analytics ao app

  1. Adicione a dependência da biblioteca do Android do Google Analytics ao seu arquivo Gradle do módulo, no nível do aplicativo (geralmente app/build.gradle):

    implementation 'com.google.firebase:firebase-analytics:17.2.0'
    
  2. Declare o objeto com.google.firebase.analytics.FirebaseAnalytics na parte superior da sua atividade:

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. Inicialize-o no método onCreate():

    Java

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

    Kotlin

    // Obtain the FirebaseAnalytics instance.
    firebaseAnalytics = FirebaseAnalytics.getInstance(this)

Registrar eventos

Depois de criar uma instância do FirebaseAnalytics, será possível usá-la para registrar eventos predefinidos ou personalizados com o método logEvent(). É possível consultar os eventos e parâmetros predefinidos na documentação de referência FirebaseAnalytics.Event e FirebaseAnalytics.Param.

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

Java

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

Kotlin

val bundle = Bundle()
bundle.putString(FirebaseAnalytics.Param.ITEM_ID, id)
bundle.putString(FirebaseAnalytics.Param.ITEM_NAME, name)
bundle.putString(FirebaseAnalytics.Param.CONTENT_TYPE, "image")
firebaseAnalytics.logEvent(FirebaseAnalytics.Event.SELECT_CONTENT, bundle)

Confirmar eventos

É possível ativar o registro detalhado para monitorar 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