Enviar eventos

En este artículo se explica cómo enviar eventos desde una aplicación a Google Analytics con el SDK de Google Analytics for Firebase. Para obtener información sobre cómo enviar eventos desde tus sitios web, consulta Enviar eventos. Para obtener más información sobre los eventos, consulta Acerca de los eventos.

Antes de empezar

Comprueba que has configurado el proyecto y que puedes acceder a Analytics tal como se describe en el artículo Empezar a usar Google Analytics.

Enviar eventos

Después de configurar la instancia FirebaseApp, puedes empezar a enviar eventos con el método logEvent(). Este método equivale al uso del comando event en gtag.js.

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

En el siguiente ejemplo se muestra cómo enviar un evento recomendado llamado select_content:

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 añadir los siguientes parámetros a cualquier evento:

  • Parámetros personalizados: se pueden usar como dimensiones y métricas en los informes de Analytics. Puedes usar dimensiones personalizadas para los datos de parámetros de eventos no numéricos y métricas personalizadas para los datos de parámetros que se representan mejor numéricamente. Una vez que hayas registrado un parámetro personalizado con el SDK, registra la dimensión o la métrica para que esos parámetros aparezcan en los informes de Analytics. Para ello, ve a: Analytics > Eventos > Gestionar definiciones personalizadas > Crear dimensiones personalizadas.
  • Parámetro kFIRParameterValue: kFIRParameterValue es un parámetro de uso general que resulta útil para acumular una métrica clave relacionada con un evento; por ejemplo, los ingresos, la distancia, el tiempo y los puntos.

Si tu aplicación tiene necesidades específicas que no cubre el 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
                                 }];

Definir parámetros de evento predeterminados

Puedes registrar parámetros de distintos eventos usando setDefaultEventParameters. Los parámetros predeterminados se asocian a todos los futuros eventos que se registran.

De la misma forma que con los parámetros personalizados, registra los parámetros de evento predeterminados para que aparezcan en los informes de Analytics.

Swift

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

Objective‑C

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

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

Para borrar un parámetro predeterminado, llama al método setDefaultEventParameters con el valor del parámetro definido como nil.

Ver eventos en la consola de depuración de Xcode

Puedes habilitar el registro detallado para monitorizar el registro de eventos por parte del SDK y así verificar que los eventos se están registrando correctamente. Esto incluye tanto los eventos registrados automáticamente como los registrados manualmente.

Para habilitar el registro detallado, sigue estos pasos:

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

La próxima vez que ejecutes tu aplicación, los eventos se mostrarán en la consola de depuración de Xcode, de modo que podrás verificar inmediatamente que se están enviando.

Ver eventos en el panel de control

Puedes consultar estadísticas agregadas sobre tus eventos en los paneles de control de la consola de Firebase. Estos paneles de control se actualizan periódicamente a lo largo del día. Para hacer pruebas de forma inmediata, utiliza el resultado del logcat tal y como se describe en la sección anterior.

Puedes acceder a estos datos desde el panel de control de eventos de la consola de Firebase. En él se muestran los informes que se crean automáticamente para cada tipo de evento que registra tu aplicación.