Registra eventos

Los eventos proporcionan información valiosa sobre lo que sucede en las apps. Por ejemplo, acciones de los usuarios, eventos del sistema o errores.

Google Analytics registra automáticamente algunos eventos. No es necesario que agregues ningún código para recibirlos. Si necesitas recopilar datos adicionales para la app, puedes registrar hasta 500 tipos distintos de eventos de Analytics en ella. No existen límites para el volumen total de eventos que registra la 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

Sigue estos pasos para usar Google Analytics:

  • Registra el proyecto de Unity y configúralo para que use Firebase.

    • Si el proyecto de Unity ya usa Firebase, significa que ya está registrado y configurado para esa plataforma.

    • Si aún no tienes un proyecto de Unity, puedes descargar una app de muestra.

  • Agrega el SDK de Firebase Unity (específicamente, FirebaseAnalytics.unitypackage) al proyecto de Unity.

Ten en cuenta que agregar Firebase a un proyecto de Unity implica realizar tareas en Firebase console y en el proyecto abierto de Unity (por ejemplo, descargar archivos de configuración de Firebase desde la consola y transferirlos al proyecto de Unity).

Registra eventos

Después de inicializar el módulo Firebase.Analytics.FirebaseAnalytics, puedes usarlo para 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 acerca de estos eventos y el momento en que deben usarse, consulta los artículos sobre eventos y propiedades del Centro de ayuda de Firebase.

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

  • Eventos sugeridos: Consulta la lista de constantes de Event.
  • Parámetros prescritos: Consulta la lista de constantes de Parameters.

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

    // Log an event with multiple parameters, passed as an array:

Firebase.Analytics.FirebaseAnalytics.LogEvent(
  Firebase.Analytics.FirebaseAnalytics.EventSelectContent,
  new Firebase.Analytics.Parameter[] {
      new Firebase.Analytics.Parameter(
        Firebase.Analytics.FirebaseAnalytics.ParameterItemId, id),
      new Firebase.Analytics.Parameter(
        Firebase.Analytics.FirebaseAnalytics.ParameterItemName, "name"),
      new Firebase.Analytics.Parameter(
        Firebase.Analytics.FirebaseAnalytics.UserPropertySignUpMethod, "Google"),
      new Firebase.Analytics.Parameter(
        "favorite_food", mFavoriteFood),
      new Firebase.Analytics.Parameter(
        "user_id", mUserId),
  }
);

Además de los parámetros prescritos, puedes agregar los siguientes parámetros a cualquier evento:

  • Parámetros personalizados: Los parámetros personalizados no aparecen directamente en los informes de Analytics, pero se pueden usar como filtros en definiciones de público que puedes aplicar a todos los informes. 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 VALUE: es un parámetro de uso general útil para acumular una métrica clave relacionada con un evento de Analytics, como los ingresos, la distancia, el tiempo y los puntos.

Si la aplicación tiene necesidades específicas que no están cubiertas por ningún tipo de evento de Analytics sugerido, puedes registrar tus propios eventos de Analytics personalizados como se muestra en este ejemplo:

Firebase.Analytics.FirebaseAnalytics.LogEvent("custom_progress_event", "percent", 0.4f);

Visualiza eventos en los resultados del registro

Android

Puedes habilitar un registro detallado en el Registro de depuración de Android Studio para verificar que el SDK registre correctamente los eventos. Esto incluye los eventos registrados tanto en forma automática como manual.

Puedes habilitar el registro detallado con una serie de comandos de adb:

adb shell setprop log.tag.FA VERBOSE
adb shell setprop log.tag.FA-SVC VERBOSE
adb logcat -v time -s FA FA-SVC

Con este comando, se muestran los eventos en el logcat de Android Studio, lo que te permitirá verificar de inmediato que se envíen los eventos.

iOS

Los eventos se registran en la consola y se pueden ver mientras se ejecuta la app con Xcode.

Visualiza eventos de Analytics en el panel

Puedes ver las estadísticas agregadas sobre tus Eventos de Analytics 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.

Para acceder a estos datos en Firebase console, haz lo siguiente:

  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, se muestran los informes de eventos que se crean automáticamente para cada tipo de evento de Analytics registrado en la app. Obtén más información sobre el panel de informes de Analytics en el Centro de ayuda de Firebase.