Ir a la consola

Registra 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 tu app debe recopilar datos adicionales, puedes registrar hasta 500 tipos de eventos de Analytics diferentes en ella. No existen límites para el volumen total de eventos que registre tu app. Ten en cuenta que los nombres de los eventos distinguen mayúsculas de minúsculas y que 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 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 muestra.

  • Agrega el SDK de Firebase Unity (en específico, FirebaseAnalytics.unitypackage) al 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 que puedas comenzar, el SDK de Analytics define varios eventos sugeridos que son comunes entre diferentes tipos de apps, como las de ventas minoristas y comercio electrónico, viajes y juegos. Para obtener más información acerca de estos eventos y el momento en que deben usarse, revisa los artículos sobre Eventos y propiedades en el 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 SELECT_CONTENT sugerido:

    // 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 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 tu 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. Entre los ejemplos, se incluyen 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 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 los eventos se envíen.

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 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:

  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, aparecen 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 de informes de Analytics en el Centro de ayuda de Firebase.