Registrar eventos

Los eventos proporcionan información valiosa sobre lo que sucede en tu app. 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 consideran eventos diferentes.

Antes de comenzar

Sigue estos pasos para usar Google Analytics:

  • Registra tu proyecto de Unity y configúralo para usar Firebase.

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

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

  • Agrega el SDK de Firebase Unity (en específico, FirebaseAnalytics.unitypackage) a tu proyecto de Unity.

Ten en cuenta que agregar Firebase a tu proyecto de Unity implica realizar tareas en Firebase console y en tu proyecto abierto de Unity (por ejemplo, descargar archivos de configuración de Firebase desde la consola y moverlos a tu 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 una cantidad de eventos recomendados 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 sobre estos eventos y el momento en que se deben usar, consulta los artículos sobre eventos recomendados en el Centro de ayuda de Google Analytics.

Puedes encontrar detalles de implementación sobre los eventos recomendados 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(
    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 están representados directamente en los informes de Analytics, pero se pueden usar como filtros en definiciones de Público que se pueden 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: 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 tu 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);

Cómo ver 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 tus eventos en el logcat de Android Studio, lo cual te ayudará a verificar de inmediato que se estén enviando.

iOS+

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

Cómo ver eventos de análisis 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 la salida del logcat como se describe en la sección anterior.

Para acceder a estos datos en Firebase console:

  1. Abre tu 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 que registra tu app. Obtén más información sobre el panel.