Registrar eventos

Los eventos brindan información sobre lo que sucede en su aplicación, como acciones del usuario, eventos del sistema o errores.

Google Analytics registra automáticamente algunos eventos por usted; No necesitas agregar ningún código para recibirlos. Si su aplicación necesita recopilar datos adicionales, puede registrar hasta 500 tipos de eventos de Analytics 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 los eventos distinguen entre mayúsculas y minúsculas y que el registro de dos eventos cuyos nombres difieren sólo en mayúsculas y minúsculas da como resultado dos eventos distintos.

Antes de que empieces

Antes de poder utilizar Google Analytics , debe:

  • Registre su proyecto de Unity y configúrelo para usar Firebase.

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

    • Si no tiene un proyecto de Unity, puede descargar una aplicación de muestra .

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

Tenga en cuenta que agregar Firebase a su proyecto de Unity implica tareas tanto en Firebase console como en su proyecto de Unity abierto (por ejemplo, descarga archivos de configuración de Firebase desde la consola y luego los mueve a su proyecto de Unity).

Registrar eventos

Después de inicializar el módulo Firebase.Analytics.FirebaseAnalytics , puedes usarlo para 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 diferentes tipos de aplicaciones, incluidas aplicaciones minoristas y de comercio electrónico, viajes y juegos. Para obtener más información sobre estos eventos y cuándo usarlos, consulte los artículos sobre eventos recomendados en el Centro de ayuda de Google Analytics.

Puede encontrar detalles de implementación para eventos recomendados en las siguientes ubicaciones:

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

El siguiente ejemplo demuestra 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(
    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 se representan directamente en sus informes de Analytics, pero se pueden usar como filtros en las 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 tu aplicación está vinculada a un proyecto de BigQuery.

  • Parámetro VALUE : VALUE es un parámetro de propósito general que es útil para acumular una métrica clave que pertenece a un evento de análisis. 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 de análisis sugerido, puede registrar sus propios eventos de análisis personalizados como se muestra en este ejemplo:

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

Ver eventos en la salida del registro

Androide

Puede habilitar el registro detallado en el registro de depuración de Android Studio para ayudar a verificar que el SDK registre correctamente los eventos. Esto incluye eventos registrados tanto automática como manualmente.

Puede 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

Este comando muestra sus eventos en el logcat de Android Studio, lo que le ayuda a verificar inmediatamente que se están enviando los eventos.

iOS+

Los eventos se registran en la consola y se pueden ver mientras se ejecuta la aplicación a través de XCode.

Ver eventos de análisis en el panel

Puede ver estadísticas agregadas sobre sus eventos de Analytics en los paneles de la consola de Firebase. Estos paneles se actualizan periódicamente a lo largo del día. Para realizar pruebas inmediatas, utilice la salida de logcat como se describe en la sección anterior.

Para acceder a estos datos en Firebase console:

  1. En Firebase console , abre tu proyecto.
  2. Seleccione Analytics en el menú para ver el panel de informes de Analytics.

La pestaña Eventos muestra los informes de eventos que se crean automáticamente para cada tipo distinto de evento de Analytics registrado por su aplicación. Lea más sobre el tablero .