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

Registrar eventos

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

Esta guía le muestra cómo registrar eventos en su aplicación.

Los eventos brindan información sobre lo que sucede en su aplicación, como acciones del usuario, eventos del sistema o errores.

Analytics registra automáticamente algunos eventos para usted; no necesita agregar ningún código para recibirlos. Si su aplicación necesita recopilar datos adicionales, puede registrar hasta 500 tipos de eventos de análisis diferentes en su aplicación. No hay límite en el volumen total de eventos que registra su aplicación. Tenga en cuenta que los nombres de eventos distinguen entre mayúsculas y minúsculas y que registrar dos eventos cuyos nombres difieren solo en mayúsculas y minúsculas dará como resultado dos eventos distintos.

Antes de que empieces

Asegúrese de haber configurado su proyecto y poder acceder a Analytics como se describe en Primeros pasos con Analytics .

Registrar eventos

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

Para ayudarlo a comenzar, el SDK de Analytics define una serie de eventos recomendados que son comunes entre los diferentes tipos de aplicaciones, incluidas las aplicaciones minoristas y de comercio electrónico, viajes y juegos. Para obtener más información sobre estos eventos y cuándo usarlos, consulte Eventos recomendados .

Puede encontrar detalles de implementación para los tipos de eventos recomendados en las siguientes ubicaciones:

El siguiente ejemplo muestra cómo registrar un evento SELECT_CONTENT :

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

Además de los parámetros prescritos, puede agregar los siguientes parámetros a cualquier evento:

  • Parámetros personalizados: los parámetros personalizados se pueden usar como dimensiones o métricas en los informes de Analytics . Puede usar dimensiones personalizadas para datos de parámetros de eventos no numéricos y métricas personalizadas para cualquier dato de parámetro mejor representado numéricamente. Una vez que haya registrado un parámetro personalizado con el SDK, registre la dimensión o la métrica para asegurarse de que esos parámetros personalizados aparezcan en los informes de Analytics. Hágalo a través de: Analytics > Eventos > Administrar definiciones personalizadas > Crear dimensiones personalizadas

    Los parámetros personalizados se pueden usar en definiciones de audiencia que se pueden aplicar a cada informe. Los parámetros personalizados también se incluyen en los datos exportados a BigQuery si su aplicación está vinculada a un proyecto de BigQuery. Encuentre consultas de muestra y mucho más en Google Analytics 4 BigQuery Export .

  • Parámetro VALUE : VALUE es un parámetro de propósito general que es útil para acumular una métrica clave que pertenece a un evento. Los ejemplos incluyen ingresos, distancia, tiempo y puntos.

Si su aplicación tiene necesidades específicas que no están cubiertas por un tipo de evento recomendado, puede registrar sus propios eventos personalizados como se muestra en este ejemplo:

Java

Bundle params = new Bundle();
params.putString("image_name", name);
params.putString("full_text", text);
mFirebaseAnalytics.logEvent("share_image", params);

Kotlin+KTX

firebaseAnalytics.logEvent("share_image") {
    param("image_name", name)
    param("full_text", text)
}

Establecer parámetros de eventos predeterminados

Puede registrar parámetros en eventos mediante setDefaultEventParameters . Los parámetros predeterminados están asociados con todos los eventos futuros que se registran.

Al igual que con los parámetros personalizados, registre los parámetros de eventos predeterminados para asegurarse de que aparezcan en los informes de Analytics.

Java

Bundle parameters = new Bundle();
params.putString("level_name", "Caverns01");
params.putInt("level_difficulty", 4);
mFirebaseAnalytics.setDefaultEventParameters(parameters);

Kotlin+KTX

val parameters = Bundle().apply {
    this.putString("level_name", "Caverns01")
    this.putInt("level_difficulty", 4)
}

firebaseAnalytics.setDefaultEventParameters(parameters)

Si se especifica un parámetro en el método logEvent() , se usa ese valor en lugar del predeterminado.

Para borrar un parámetro predeterminado, llame al método setDefaultEventParameters con el parámetro establecido en null .

Ver eventos en el registro de depuración de Android Studio

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.

Ver eventos en el tablero

Puede ver estadísticas agregadas sobre sus eventos en los paneles de la consola de Firebase. Estos tableros se actualizan periódicamente a lo largo del día. Para pruebas inmediatas, use la salida logcat como se describe en la sección anterior.

Puede acceder a estos datos desde el panel de Eventos en la consola de Firebase. Este tablero muestra los informes de eventos que se crean automáticamente para cada tipo distinto de evento registrado por su aplicación.