Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Comience con Google Analytics

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Este inicio rápido le muestra cómo agregar Google Analytics a su aplicación y comenzar a registrar eventos.

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

  • Eventos: lo que sucede en su aplicación, como acciones del usuario, eventos del sistema o errores.
  • Propiedades de usuario: atributos que define para describir segmentos de su base de usuarios, como la preferencia de idioma o la ubicación geográfica.

Analytics registra automáticamente algunos eventos y propiedades de usuario ; no necesita agregar ningún código para habilitarlos.

Antes de que empieces

Si aún no lo ha hecho, agregue Firebase a su proyecto de Android y asegúrese de que Google Analytics esté habilitado en su proyecto de Firebase:

  • Si está creando un nuevo proyecto de Firebase, habilite Google Analytics durante el flujo de trabajo de creación del proyecto.

  • Si está utilizando un proyecto de Firebase existente que no tiene habilitado Google Analytics, vaya a la pestaña Integraciones de su > Configuración del proyecto para habilitarlo.

Cuando habilita Google Analytics en su proyecto, sus aplicaciones de Firebase se vinculan a los flujos de datos de Google Analytics.

Agregue el SDK de Analytics a su aplicación

  1. En el archivo Gradle de tu módulo (nivel de aplicación) (generalmente <project>/<app-module>/build.gradle ), agrega la dependencia para la biblioteca de Android de Analytics. Recomendamos usar Firebase Android BoM para controlar el control de versiones de la biblioteca.

    Java

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.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'
    }
    

    Al usar Firebase Android BoM , su aplicación siempre usará versiones compatibles de las bibliotecas de Firebase Android.

    (Alternativa) Agregar dependencias de la biblioteca de Firebase sin usar el BoM

    Si elige no usar Firebase BoM, debe especificar cada versión de la biblioteca de Firebase en su línea de dependencia.

    Tenga en cuenta que si usa varias bibliotecas de Firebase en su aplicación, le recomendamos enfáticamente que use la lista de materiales para administrar las versiones de la biblioteca, lo que garantiza que todas las versiones sean compatibles.

    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.2.0'
    }
    

    Kotlin+KTX

    dependencies {
        // Import the BoM for the Firebase platform
        implementation platform('com.google.firebase:firebase-bom:31.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-ktx'
    }
    

    Al usar Firebase Android BoM , su aplicación siempre usará versiones compatibles de las bibliotecas de Firebase Android.

    (Alternativa) Agregar dependencias de la biblioteca de Firebase sin usar el BoM

    Si elige no usar Firebase BoM, debe especificar cada versión de la biblioteca de Firebase en su línea de dependencia.

    Tenga en cuenta que si usa varias bibliotecas de Firebase en su aplicación, le recomendamos enfáticamente que use la lista de materiales para administrar las versiones de la biblioteca, lo que garantiza que todas las versiones sean compatibles.

    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-ktx:21.2.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

Empezar a registrar eventos

Una vez que haya creado una instancia de FirebaseAnalytics , puede comenzar a registrar eventos con el método logEvent() .

Se recomiendan ciertos eventos para todas las aplicaciones ; otros se recomiendan para tipos de negocios o verticales específicos. Debe enviar eventos sugeridos junto con sus parámetros prescritos, para garantizar el máximo detalle disponible en sus informes y beneficiarse de futuras funciones e integraciones a medida que estén disponibles. Esta sección demuestra el registro de un evento predefinido. Para obtener más información sobre el registro de eventos, consulte Eventos de registro .

El siguiente código registra un evento SELECT_CONTENT cuando un usuario hace clic en un elemento específico de su aplicación.

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

Puede habilitar el registro detallado para monitorear el registro de eventos por parte del SDK para ayudar a verificar que los eventos se registren correctamente. Esto incluye eventos registrados tanto automática como manualmente.

Puede habilitar el registro detallado con una serie 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 muestra sus eventos en el logcat de Android Studio, lo que lo ayuda a verificar de inmediato que los eventos se envían.

Próximos pasos