获取我们在 Firebase 峰会上发布的所有信息,了解 Firebase 可如何帮助您加快应用开发速度并满怀信心地运行应用。了解详情

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 para usted; no necesita 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 eventos distinguen entre mayúsculas y minúsculas y que registrar dos eventos cuyos nombres difieren solo en mayúsculas y minúsculas dará como resultado dos eventos distintos.

Antes de que empieces

Antes de poder utilizar Google Analytics , debe:

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

    • Si su 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 .

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

Tenga en cuenta que agregar Firebase a su proyecto de Unity implica tareas tanto en la consola de Firebase 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

Una vez que haya inicializado el módulo Firebase.Analytics.FirebaseAnalytics , puede usarlo para registrar eventos con el método LogEvent() .

Para ayudarlo a comenzar, el SDK de Analytics define una serie de eventos sugeridos que son comunes entre los diferentes tipos de aplicaciones, incluidas las aplicaciones minoristas y de comercio electrónico, viajes y juegos. Para obtener más información sobre estos eventos y cuándo usarlos, explore los artículos Eventos y propiedades en el Centro de ayuda de Firebase.

Puede encontrar detalles de implementación para los tipos de eventos sugeridos en las siguientes ubicaciones:

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

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, puede 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 su 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 Analytics. 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 registra 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 lo ayuda a verificar de inmediato que los eventos se envían.

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 tablero

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

Para acceder a estos datos en Firebase console:

  1. En la consola de Firebase , 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 análisis registrado por su aplicación. Obtenga más información sobre el panel de informes de Analytics en el Centro de ayuda de Firebase.