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 configurado la instancia de 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 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 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, 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 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 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 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() , 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 nil .

Ver eventos en la consola de depuración de Xcode

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 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 transmitidos al iniciar, 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 lo ayudará a verificar de inmediato que se están enviando los eventos.

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.