Ir a la consola

Registra eventos

Con esta guía, aprenderás a registrar eventos en una app.

Los eventos proporcionan información valiosa sobre lo que sucede en tu 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 tu 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 que puede registrar tu app. Ten en cuenta que los nombres de los eventos distinguen mayúsculas de minúsculas y, 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 tu proyecto esté configurado y pueda acceder a Analytics como se describe en Comienza a usar Analytics.

Registra eventos

Después de configurar la instancia FirebaseApp, puedes comenzar a registrar eventos con el método logEvent().

Para ayudarte a 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 videojuegos. Para obtener más información sobre estos eventos y cuándo usarlos, busca los artículos [Eventos y propiedades][suggested-events-hc] en el Centro de ayuda de Firebase.

Puedes obtener información sobre la implementación en la referencia de constantes para Swift y Objective-C.

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

Swift

Analytics.logEvent(AnalyticsEventSelectContent, parameters: [
  AnalyticsParameterItemID: "id-\(title!)",
  AnalyticsParameterItemName: title!,
  AnalyticsParameterContentType: "cont"
  ])

Objective‑C

[FIRAnalytics logEventWithName:kFIREventSelectContent
                    parameters:@{
                                 kFIRParameterItemID:[NSString stringWithFormat:@"id-%@", self.title],
                                 kFIRParameterItemName:self.title,
                                 kFIRParameterContentType:@"image"
                                 }];

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 a un proyecto de BigQuery.

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

Si tu aplicación 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:

Swift

Analytics.logEvent("share_image", parameters: [
  "name": name as NSObject,
  "full_text": text as NSObject
  ])

Objective‑C

 [FIRAnalytics logEventWithName:@"share_image"
                    parameters:@{
                                 @"name": name,
                                 @"full_text": text
                                 }];

Cómo ver eventos en la consola de depuración de Xcode

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 de la siguiente manera:

  1. En Xcode, selecciona Product > Scheme > Edit scheme… (Producto > Esquema > Editar esquema…).
  2. Selecciona Run (Ejecutar) en el menú de la izquierda.
  3. Selecciona la pestaña Arguments (Argumentos).
  4. En la sección Arguments Passed On Launch (Argumentos pasados al inicio), agrega -FIRAnalyticsDebugEnabled.

La próxima vez que ejecutes tu app, los eventos se mostrarán en la consola de depuración de Xcode, lo que te ayuda a identificar de inmediato los eventos que se envían.

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 los datos en el panel Eventos de Firebase console. En este panel, se muestran los informes de eventos que se crean automáticamente para cada tipo distinto de evento que registra tu app.