Comece a usar o Google Analytics

Este guia de início rápido mostra como adicionar o Google Analytics ao seu aplicativo e começar a registrar eventos.

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

  • Eventos: o que está acontecendo no seu aplicativo, 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 ; você não precisa adicionar nenhum código para ativá-los.

Antes de você começar

Adicione o Firebase ao seu projeto Android , caso ainda não o tenha feito, e certifique-se de que o Google Analytics esteja ativado no seu projeto Firebase:

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

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

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

Adicione o SDK do Analytics ao seu aplicativo

  1. No arquivo Gradle do módulo (nível do aplicativo) (geralmente <project>/<app-module>/build.gradle.kts ou <project>/<app-module>/build.gradle ), adicione a dependência da biblioteca do Analytics para Android. Recomendamos usar o Firebase Android BoM para controlar o controle de versão da biblioteca.

    dependencies {
            // Import the BoM for the Firebase platform
        implementation    (platform("com.google.firebase:firebase-bom:32.7.4"))

            // 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")
    }

    Ao usar o Firebase Android BoM , seu aplicativo sempre usará versões compatíveis das bibliotecas do Firebase Android.

    Se você optar por não usar o Firebase BoM, deverá especificar cada versão da biblioteca do Firebase em sua linha de dependência.

    Observe que se você usa várias bibliotecas do Firebase no seu aplicativo, é altamente recomendável usar a BoM para gerenciar as versões da biblioteca, o que garante que todas as versões sejam compatíveis.

    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.1")
    }
     Procurando um módulo de biblioteca específico para Kotlin? A partir de outubro de 2023 (Firebase BoM 32.5.0) , tanto os desenvolvedores Kotlin quanto os Java podem depender do módulo da biblioteca principal (para obter detalhes, consulte o FAQ sobre esta iniciativa ).

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

    Kotlin+KTXJava
    private lateinit var firebaseAnalytics: FirebaseAnalytics
    MainActivity.kt
    private FirebaseAnalytics mFirebaseAnalytics;
    MainActivity.java

  3. Inicialize-o no método onCreate() :

    Kotlin+KTXJava
    // Obtain the FirebaseAnalytics instance.
    firebaseAnalytics     = Firebase.analytics
    MainActivity.kt
    // Obtain the FirebaseAnalytics instance.
    mFirebaseAnalytics     = FirebaseAnalytics.getInstance(this);
    MainActivity.java

Comece a registrar eventos

Depois de criar uma instância FirebaseAnalytics , você poderá começar a registrar eventos com o método logEvent() .

Certos eventos são recomendados para todos os aplicativos ; outros são recomendados para tipos de negócios ou setores específicos. Você deve enviar eventos sugeridos junto com seus parâmetros prescritos, para garantir o máximo de detalhes disponíveis em seus relatórios e para se beneficiar de recursos e integrações futuras assim que estiverem disponíveis. Esta seção demonstra o registro de um evento predefinido. Para obter mais informações sobre o registro 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 aplicativo.

Kotlin+KTXJava
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

Você pode ativar o registro detalhado para monitorar o registro de eventos pelo SDK para ajudar a verificar se os eventos estão sendo registrados corretamente. Isso inclui eventos registrados automática e manualmente.

Você pode ativar 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

Este comando exibe seus eventos no logcat do Android Studio, ajudando você a verificar imediatamente se os eventos estão sendo enviados.

Próximos passos