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.

Antes de comenzar

Si es la primera vez que agregas Analytics a la app, sigue estos pasos:

Conecta la app en Firebase console

  1. Instala el SDK de Firebase.
  2. En Firebase console, agrega la app al proyecto de Firebase.

Agrega funciones de Analytics a la app

  1. Agrega la dependencia para Firebase al Podfile:
    pod 'Firebase/Core'
  2. Ejecuta pod install y abre el archivo .xcworkspace creado.
  3. Importa el módulo de Firebase en UIApplicationDelegate:

    Swift

    import Firebase
    

    Objective-C

    @import Firebase;
    
  4. Configura una instancia compartida de FirebaseApp, generalmente en el método application:didFinishLaunchingWithOptions: de tu aplicación:

    Swift

    // Use Firebase library to configure APIs
    FirebaseApp.configure()
    

    Objective-C

    // Use Firebase library to configure APIs
    [FIRApp configure];
    

Registra eventos

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

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 información sobre la implementación en las siguientes ubicaciones:

  • Eventos sugeridos: consulta el archivo de encabezado FIREventNames.h.
  • Parámetros prescritos: consulta el archivo de encabezado FIRParameterNames.h.

El siguiente ejemplo 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 con un proyecto de BigQuery.

  • Parámetro kFIRParameterValue: kFIRParameterValue 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:

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 controlar el registro de eventos a través del SDK, a fin de verificar que los eventos se registren de manera adecuada. Esto incluye eventos registrados de manera automática y manual.

Puedes habilitar el registro detallado de la siguiente manera:

  1. En Xcode, selecciona Producto > Esquema > Editar esquema…
  2. Selecciona Ejecutar en el menú de la izquierda.
  3. Selecciona la pestaña Argumentos.
  4. En la sección Argumentos pasados al inicio, agrega -FIRAnalyticsDebugEnabled.

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

Cómo ver eventos en el panel

Puedes ver las estadísticas globales de los eventos de Analytics en los paneles de Firebase console. Estos paneles se actualizan periódicamente durante el día. Para hacer pruebas inmediatas, usa el resultado de la consola de depuración 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, aparecen los informes de eventos que se crean automáticamente para cada tipo de evento de Analytics que registra tu app. Para obtener más información sobre el panel de informes de Analytics, consulta el Centro de ayuda de Firebase.

Enviar comentarios sobre…

¿Necesitas ayuda? Visita nuestra página de asistencia.