Ir a la consola

Registra eventos

Los eventos proporcionan información valiosa sobre lo que sucede en la app. Por ejemplo, acciones de los usuarios, eventos del sistema o errores.

Analytics registra automáticamente algunos eventos; no es necesario que agregues código para recibirlos. Si la app debe recopilar datos adicionales, puedes registrar hasta 500 tipos de eventos de Analytics diferentes en ella. No existen límites para el volumen total de eventos registrados por la app. Ten en cuenta que los nombres de los eventos distinguen mayúsculas de minúsculas y que si se registran dos eventos con nombres iguales que solo difieren en el uso de mayúsculas, se registrarán dos eventos diferentes.

Antes de comenzar

Asegúrate de que configuraste tu proyecto y de que puedes acceder a Analytics, tal como se describe en Primeros pasos con Analytics para Android.

Registra eventos

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

Para que puedas comenzar, el SDK de Analytics define varios eventos sugeridos que son comunes entre diferentes tipos de apps, como las de venta minorista y comercio electrónico, viajes y juegos. Para obtener más información acerca de estos eventos y el momento en que deben usarse, revisa los artículos sobre Eventos y propiedades en el Centro de ayuda de Firebase.

Puedes encontrar detalles sobre la implementación de los tipos de eventos sugeridos en las siguientes ubicaciones:

En el siguiente ejemplo, se muestra cómo registrar un evento SELECT_CONTENT sugerido:

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)

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

  • Parámetros personalizados: Pueden registrarse para que se incluyan en los informes de Analytics. También se pueden utilizar como filtros en las definiciones de públicos que se pueden aplicar a cada informe. Los parámetros personalizados también se incluyen en los datos exportados a BigQuery si la app está vinculada con un proyecto de BigQuery.

  • Parámetro VALUE: VALUE es un parámetro de uso general que resulta útil para acumular una métrica clave relacionada con un evento. Entre los ejemplos, se incluyen los ingresos, la distancia, el tiempo y los puntos.

Si la app tiene necesidades específicas que no están cubiertas por un tipo de evento sugerido, puedes registrar tus 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

val params = Bundle()
params.putString("image_name", name)
params.putString("full_text", text)
firebaseAnalytics.logEvent("share_image", params)

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

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

Puedes habilitar el registro detallado con una serie de 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 tus eventos en el logcat de Android Studio, lo que te ayudará a verificar de inmediato que los eventos se envíen.

Visualiza eventos en el panel

Puedes ver estadísticas globales acerca de tus eventos en los paneles de Firebase console. Estos paneles se actualizan periódicamente durante el día. Para hacer pruebas inmediatas, usa la salida del logcat como se describe en la sección anterior.

Puedes acceder a estos datos en Firebase console de la siguiente manera:

  1. Abre el proyecto en Firebase console.
  2. Selecciona Analytics en el menú para ver el panel de informes de Analytics.

En la pestaña Eventos, se muestran los informes de eventos que se crean automáticamente para cada tipo distinto de evento que registra tu app. Obtén más información sobre el panel de informes de Analytics en el Centro de ayuda de Firebase.