Análisis de App Center (Unity)

App Center Analytics le ayuda a comprender el comportamiento del usuario y la interacción del cliente para mejorar la aplicación. El SDK captura automáticamente el recuento de sesiones y las propiedades del dispositivo, como el modelo, la versión del sistema operativo, etc. Puede definir sus propios eventos personalizados para medir las cosas que le importan. Toda la información capturada está disponible en el portal de App Center para analizar los datos.

Siga las instrucciones de la sección Introducción a Unity si aún no ha configurado el SDK en la aplicación.

using Microsoft.AppCenter.Unity.Analytics;

Información de sesión y dispositivo

Una vez que agregue App Center Analytics e inicie el SDK, realizará un seguimiento automático de las sesiones y las propiedades del dispositivo, como la versión del sistema operativo, el modelo, etc. sin necesidad de código adicional en la aplicación.

Eventos personalizados

Puede realizar un seguimiento de sus propios eventos personalizados con hasta 20 propiedades para saber lo que sucede en la aplicación, comprender las acciones del usuario y ver los agregados en el portal de App Center.

Utiliza el método TrackEvent() para realizar un seguimiento de tus eventos con propiedades. Puede enviar hasta 200 nombres de evento distintos. Hay un límite máximo de 256 caracteres por nombre de evento y 125 caracteres por nombre y valor de propiedad de evento.

Analytics.TrackEvent("Video clicked", new Dictionary<string, string> {
	{ "Category", "Music" },
	{ "FileName", "favorite.avi" }
});

Las propiedades de los eventos son opcionales: si solo desea realizar un seguimiento de un evento, use este ejemplo en su lugar:

Analytics.TrackEvent("Video clicked");

Habilitación o deshabilitación de App Center Analytics en tiempo de ejecución

Puede habilitar y deshabilitar App Center Analytics en tiempo de ejecución. Si la deshabilita, el SDK dejará de recopilar información de análisis para la aplicación. Para deshabilitar Analytics, use la API siguiente y pase false como parámetro.

Analytics.SetEnabledAsync(false);

Para volver a habilitar App Center Analytics, use la misma API, pero pase true como parámetro.

Analytics.SetEnabledAsync(true);

El estado se conserva en el almacenamiento del dispositivo en los inicios de la aplicación.

Esta API es asincrónica, puede obtener más información en nuestra guía de API asincrónicas de App Center .

Comprobación de si App Center Analytics está habilitado

También puede comprobar si App Center Analytics está habilitado o no.

bool isEnabled = await Analytics.IsEnabledAsync();

Prioridad del evento y persistencia

Puede realizar un seguimiento de los eventos críticos para la empresa que tienen mayor importancia que otros eventos.

Los desarrolladores pueden establecer la persistencia de eventos como Normal (Flags.PersistenceNormal en la API) o Crítico (Flags.PersistenceCritical en la API).

Puede usar la SIGUIENTE API para realizar un seguimiento de un evento como Crítico:

Analytics.TrackEvent("eventName", Flags.PersistenceCritical);

Si está utilizando propiedades personalizadas:

Analytics.TrackEvent("eventName", new Dictionary<string, string> {
	{ "Category", "Music" },
	{ "FileName", "favorite.avi" }
}, Flags.PersistenceCritical);

Pausar y reanudar el envío de registros

Pausar la transmisión de eventos puede ser útil en escenarios en los que la aplicación necesita controlar el ancho de banda de red para necesidades más críticas para la empresa. Puede pausar el envío de registros al back-end de App Center. Cuando se pausa, los eventos se pueden seguir y guardar, pero no se envían inmediatamente. Los eventos que sigue la aplicación cuando está pausada solo se enviarán cuando llames a Analytics.Resume.

Analytics.Pause();
Analytics.Resume();

Esta API es asincrónica, puede obtener más información en nuestra guía de API asincrónicas de App Center .

Administración de la sesión de inicio

De forma predeterminada, el identificador de sesión depende del ciclo de vida de la aplicación. Si desea controlar manualmente el inicio de una nueva sesión, siga los pasos siguientes:

• Desactive la casilla Habilitar rastreador manual de sesión en la sección Análisis del objeto de juego con AppCenterBehavior conectado.
• A continuación, puede usar la StartSession API después de AppCenter.Start:

Analytics.StartSession();

Tamaño del almacenamiento local

De forma predeterminada, el SDK almacena hasta 10 MB de registros en el almacenamiento.

Sin acceso a Internet

Cuando no hay conectividad de red, el SDK guarda hasta 10 MB de registros en el almacenamiento local. Una vez que el almacenamiento esté lleno, el SDK comenzará a descartar los registros antiguos para dejar espacio a los nuevos registros. Una vez que el dispositivo vuelva a acceder a Internet, el SDK enviará registros en el lote de 50 o después de cada 6 segundos.

Registros de eventos de procesamiento por lotes

El SDK de App Center carga los registros en un lote de 50 y, si el SDK no tiene 50 registros para enviar, seguirá enviando registros después de 6 segundos. Puede haber un máximo de tres lotes enviados en paralelo.

Lógica de reintento y retroceso

El SDK de App Center admite reintentos de retroceso en errores de red recuperables. A continuación se muestra la lógica de reintento:

• 3 intentos máximos por solicitud.
• Cada solicitud tiene su propio sistema de gestión de reintentos.
• Todos los canales de transmisión están deshabilitados (hasta el siguiente proceso de la aplicación) después de que una solicitud agote todos sus intentos de reintento.

Lógica de retroceso

• 50% selección aleatoria, primer reintento entre 5s y 10s, segundo reintento entre 2,5 y 5 minutos, último intento entre 10 y 20 minutos.
• Si la red cambia de apagado a activado (o de wi-fi a móvil), los estados de reintento se restablecen y las solicitudes se reintentan inmediatamente.