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 tu 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 aún no lo has hecho, agrega Firebase a tu proyecto de Android y asegúrate de que Google Analytics esté habilitado en el proyecto de Firebase:

  • Si quieres crear un proyecto de Firebase nuevo, habilita Google Analytics durante el flujo de trabajo de su creación.

  • Si ya tienes un proyecto de Firebase que no tiene habilitado Google Analytics, puedes habilitarlo en la pestaña Integraciones de la Configuración del proyecto.

Cuando habilitas Google Analytics en tu proyecto, las apps de Firebase se vinculan a las transmisiones de datos de Google Analytics.

Agrega el SDK de Analytics a tu app

  1. Agrega la dependencia de la biblioteca de Android de Google Analytics al archivo Gradle (generalmente app/build.gradle) de tu módulo (al nivel de la app), como se indica a continuación:

    Java

    implementation 'com.google.firebase:firebase-analytics:17.5.0'
    

    Kotlin+KTX

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

    Java

    private FirebaseAnalytics mFirebaseAnalytics;

    Kotlin+KTX

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

    Java

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

    Kotlin+KTX

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

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+KTX

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

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.

Próximos pasos