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 para Firebase registra de forma automática algunos eventos; no es necesario que agregues 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

A fin de poder usar Google Analytics para Firebase, debes crear un proyecto de Firebase y agregar los paquetes del SDK de Firebase Unity a tu proyecto de Unity.

Configuración:

Requisitos previos

Android

  • Unity 5.0 o una versión más reciente
  • NDK de Android 10d o una versión más reciente

iOS

  • Unity 5.0 o una versión más reciente
  • Xcode 8.0 o una versión más reciente

Si todavía no tienes un proyecto de Unity, puedes descargar uno de los ejemplos de inicio rápido para probar una función de Firebase específica. Si usas un inicio rápido, recuerda obtener el identificador de paquete en la configuración del proyecto, ya que lo necesitarás en el próximo paso.

Configura la app en Firebase console

Para agregar Firebase a la app, debes tener un proyecto y un archivo de configuración de Firebase.

Para crear un proyecto de Firebase:

  1. Crea un proyecto en Firebase console si no lo hiciste anteriormente. Haz clic en Agregar proyecto. Si ya tienes un proyecto de Google asociado con la app para dispositivos móviles, selecciónalo en el menú desplegable Nombre del proyecto. De lo contrario, escribe un nombre para crear un proyecto nuevo.
  2. Opcional: Edita el ID del proyecto. Automáticamente, se asigna un ID único a tu proyecto, que se usa en características visibles de Firebase de manera pública, como las URL de bases de datos y tu subdominio de Firebase Hosting. Puedes cambiarlo en este momento si deseas usar un subdominio específico.
  3. Sigue los pasos de configuración restantes y haz clic en Crear proyecto (o Agregar Firebase si usas un proyecto existente) a fin de aprovisionar recursos para el proyecto. Este proceso suele tardar algunos minutos. Cuando finalice, verás la descripción general del proyecto.

Android

  1. Haz clic en Agrega Firebase a tu app para Android y sigue los pasos de la configuración. Si importas un proyecto de Google existente, es posible que esto ocurra de forma automática y solo tengas que descargar el archivo de configuración.
  2. Ingresa el nombre del paquete de la app cuando se te solicite. Es importante que ingreses el nombre de paquete que tu app está usando. Esto solo se puede configurar cuando agregas una app al proyecto de Firebase.
  3. Durante el proceso, descargarás un archivo google-services.json. Puedes volver a descargarlo en cualquier momento.
  4. Después de agregar el código de inicialización, ejecuta la app para verificar con Firebase console que instalaste Firebase correctamente.

iOS

  1. Haz clic en Agrega Firebase a tu app para iOS y sigue los pasos de configuración. Si importas un proyecto de Google existente, es posible que esto ocurra de forma automática y solo tengas que descargar el archivo de configuración.
  2. Ingresa el ID de paquete de la app cuando se te solicite. Es importante que ingreses el ID de paquete que está usando la app. Esto solo se puede configurar cuando agregas una app al proyecto de Firebase.
  3. Durante el proceso, descargarás un archivo GoogleService-Info.plist. Puedes volver a descargarlo en cualquier momento.
  4. Después de agregar el código de inicialización, ejecuta la app para verificar con Firebase console que instalaste Firebase correctamente.
  5. Arrastra el archivo GoogleService-Info.plist que se descargó de Firebase console a cualquier carpeta del proyecto de Unity.

Agrega el SDK de Firebase Unity a la app

  1. Descarga el SDK de Firebase Unity.
  2. Selecciona el elemento de menú Recursos > Importar paquete > Paquete personalizado.
  3. Importa el paquete FirebaseAnalytics.unitypackage del SDK de Firebase Unity que descargaste anteriormente.
  4. Cuando aparezca la ventana Importar paquete de Unity, haz clic en el botón Importar.

Inicializa el SDK

El SDK de Firebase Unity en Android requiere los Servicios de Google Play actualizados. Se debe agregar el siguiente código al inicio de la aplicación para buscar y, de forma opcional, actualizar los Servicios de Google Play a la versión que el SDK de Firebase Unity requiere. De esta manera, se podrá llamar a otros métodos en el SDK.

Firebase.FirebaseApp.CheckAndFixDependenciesAsync().ContinueWith(task => {
  var dependencyStatus = task.Result;
  if (dependencyStatus == Firebase.DependencyStatus.Available) {
    // Create and hold a reference to your FirebaseApp, i.e.
    //   app = Firebase.FirebaseApp.DefaultInstance;
    // where app is a Firebase.FirebaseApp property of your application class.

    // Set a flag here indicating that Firebase is ready to use by your
    // application.
  } else {
    UnityEngine.Debug.LogError(System.String.Format(
      "Could not resolve all Firebase dependencies: {0}", dependencyStatus));
    // Firebase Unity SDK is not safe to use here.
  }
});

Compila la app

Android

  1. Selecciona la opción de menú File > Build Settings.
  2. Selecciona Android en la lista Platform.
  3. Haz clic en Switch Platform para establecer a Android como plataforma seleccionada.
  4. Espera a que se detenga el ícono giratorio (de compilación en proceso) que se encuentra en la esquina inferior derecha de la barra de estado de Unity.
  5. Haz clic en Build and Run.

iOS

  1. Selecciona la opción de menú File > Build Settings.
  2. Selecciona iOS en la lista Platform.
  3. Haz clic en Switch Platform para establecer a iOS como plataforma seleccionada.
  4. Espera a que se detenga el ícono giratorio (de compilación en proceso) que se encuentra en la esquina inferior derecha de la barra de estado de Unity.
  5. Haz clic en Build and Run.

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. Para obtener más información sobre el panel de informes de Analytics, consulta el Centro de ayuda de Firebase.

Enviar comentarios sobre...

Si necesitas ayuda, visita nuestra página de asistencia.