Comienza a usar Google Analytics

En esta guía de inicio rápido, aprenderás cómo agregar Google Analytics a tu app y comenzar a registrar eventos.

Google Analytics recopila datos de uso y comportamiento de tu app. El SDK registra dos tipos principales de información:

  • Eventos: Lo que sucede en la app, como las acciones de los usuarios, los eventos del sistema o los errores.
  • Propiedades del usuario: Los atributos que defines para describir segmentos de la base de usuarios, como la preferencia de idioma o la ubicación geográfica.

Analytics registra automáticamente algunos eventos y propiedades del usuario; no es necesario que agregues código para habilitarlos.

Antes de comenzar

Si quieres crear un proyecto nuevo, agrega Firebase a tu proyecto de Android y sigue los pasos para configurar Google Analytics en el proyecto durante su creación.

Si ya tienes un proyecto y no configuraste Google Analytics, puedes vincular el servicio al proyecto en la pestaña Integraciones de settings > Configuración del proyecto.

Agrega el SDK de Analytics a tu app

  1. Agrega la dependencia de la biblioteca de Android de Google Analytics al archivo Gradle (al nivel de la app) de tu módulo (generalmente app/build.gradle):

    implementation 'com.google.firebase:firebase-analytics:17.2.1'
    
  2. Declara el objeto com.google.firebase.analytics.FirebaseAnalytics en la parte superior de tu actividad:

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin

    private lateinit var firebaseAnalytics: FirebaseAnalytics
  3. Inicialízalo en el método onCreate():

    Java

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

    Kotlin

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

Comienza a registrar eventos

Después de crear una instancia de FirebaseAnalytics, puedes comenzar a registrar eventos con el método logEvent().

Algunos eventos se recomiendan para todas las apps; otros se recomiendan para verticales o tipos de empresas específicos. Debes enviar los eventos sugeridos junto con sus parámetros prescritos a fin de asegurarte de tener la mayor cantidad posible de detalles en tus informes y aprovechar las integraciones y funciones futuras cuando estén disponibles. En esta sección, se muestra cómo registrar un evento predefinido. Para obtener más información sobre cómo registrar eventos, consulta Registra eventos.

El siguiente código permite registrar un evento SELECT_CONTENT cuando un usuario hace clic en un elemento específico de tu app.

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)

Puedes habilitar el registro detallado para supervisar el registro de eventos a través del SDK a fin de verificar que se registren correctamente. Esto incluye eventos registrados de manera automática y manual.

Puedes habilitar el registro detallado con los siguientes comandos de 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 muestra los eventos en el logcat de Android Studio, lo que te permitirá verificar de inmediato que se envíen los eventos.

Pasos siguientes