Registrar eventos

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 por usted; No necesitas 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 los eventos distinguen entre mayúsculas y minúsculas y que el registro de dos eventos cuyos nombres difieren sólo en mayúsculas y minúsculas da como resultado dos eventos distintos.

Antes de que empieces

Asegúrese de haber configurado su proyecto y de poder acceder a Analytics como se describe en Introducción a Analytics .

Registrar eventos

Una vez que haya configurado la instancia FirebaseApp , puede comenzar a 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 diferentes tipos de aplicaciones, incluidas 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 en la referencia de constantes para Swift y Objective-C .

El siguiente ejemplo demuestra cómo registrar un evento kFIRSelectContent recomendado:

Rápido

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

C objetivo

[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: los parámetros personalizados se pueden utilizar como dimensiones o métricas en los informes de Analytics . Puede utilizar 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 mediante el SDK, registre la dimensión o métrica para asegurarse de que esos parámetros personalizados aparezcan en los informes de Analytics. Haga esto a través de: Analytics > Eventos > Administrar definiciones personalizadas > Crear dimensiones personalizadas

    Se pueden utilizar parámetros personalizados en las 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 tu 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 kFIRParameterValue : kFIRParameterValue 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:

Rápido

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

C objetivo

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

Establecer parámetros de evento predeterminados

Puede registrar parámetros en todos los eventos utilizando 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 garantizar que esos parámetros personalizados aparezcan en los informes de Analytics.

Rápido

Analytics.setDefaultEventParameters([
  "level_name": "Caverns01",
  "level_difficulty": 4
])

C objetivo

[FIRAnalytics setDefaultEventParameters:
  @{
  @"level_name": "Caverns01",
  @"level_difficulty": @(4)
}];

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

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

Ver eventos en la consola de depuración de Xcode

Puede habilitar el registro detallado para monitorear el registro de eventos mediante el SDK para ayudar a verificar que los eventos se estén registrando correctamente. Esto incluye eventos registrados tanto automática como manualmente.

Puede habilitar el registro detallado de la siguiente manera:

  1. En Xcode, seleccione Producto > Esquema > Editar esquema...
  2. Seleccione Ejecutar en el menú de la izquierda.
  3. Seleccione la pestaña Argumentos .
  4. En la sección Argumentos pasados ​​en el lanzamiento , agregue -FIRAnalyticsVerboseLoggingEnabled .

La próxima vez que ejecute su aplicación, sus eventos se mostrarán en la consola de depuración de Xcode, lo que le ayudará a verificar inmediatamente que se están enviando los eventos.

Ver eventos en el panel

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

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