Análisis de App Center (Apache Cordova)

Importante

Visual Studio App Center está programado para retirarse el 31 de marzo de 2025. Aunque puede seguir usando Visual Studio App Center hasta que se retire por completo, hay varias alternativas recomendadas a las que puede considerar la posibilidad de migrar.

Obtenga más información sobre las escalas de tiempo y las alternativas de soporte técnico.

• Android
• iOS
• React Native
• Windows
• MAUI/Xamarin
• Unity
• macOS
• tvOS
• Cordova

Nota

El soporte técnico para aplicaciones cordova finalizó en abril de 2022. Obtenga más información en el blog de App Center.

App Center Analytics le ayuda a comprender el comportamiento del usuario y la participació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 la sección Introducción si aún no ha configurado el SDK en la aplicación.

Información de la sesión y del dispositivo

Una vez que agregue App Center Analytics a la aplicación y se 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.

Eventos personalizados

Puede realizar un seguimiento de sus propios eventos personalizados con hasta 20 propiedades para comprender la interacción entre los usuarios y la aplicación.

Una vez que haya iniciado el SDK, use el método para realizar un trackEvent seguimiento de los eventos con propiedades. Puede enviar hasta 200 nombres de eventos distintos. Además, hay un límite máximo de 256 caracteres por nombre de evento y 125 caracteres por nombre de propiedad de evento y valor de propiedad de evento.

var success = function() {
    console.log("Event tracked");
}

var error = function(error) {
    console.error(error);
}
AppCenter.Analytics.trackEvent('Video clicked', { Category: 'Music', FileName: 'favorite.avi' }, success, error);

Esta función usa el tercer parámetro como devolución de llamada correcta, que devuelve una cadena vacía y un cuarto parámetro como devolución de llamada de error que devuelve un error.

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

var success = function() {
    console.log("Event tracked");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.trackEvent('Video clicked', success, error);

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 ya no recopilará información de análisis para la aplicación.

var success = function() {
    console.log("Analytics disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(false, success, error);

Esta función usa el segundo parámetro como devolución de llamada correcta, que devuelve una cadena vacía y un tercer parámetro como devolución de llamada de error que devuelve un error. Para volver a habilitar App Center Analytics, use la misma API, pero pase true como parámetro.

var success = function() {
    console.log("Analytics enabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(true, success, error);

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

Comprobación de si App Center Analytics está habilitado

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

var success = function(result) {
    console.log("analytics " + (result) ? "enabled" : "disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.isEnabled(success, error);

Esta función usa el primer parámetro como devolución de llamada correcta, que devuelve un boolean parámetro y el segundo como devolución de llamada de error que devuelve un error.

Espere a que JS habilite App Center Analytics.

En algunos casos, es posible que una aplicación quiera preguntar a los usuarios si quieren compartir información de análisis. En ese caso, debe cambiar la preferencia APPCENTER_ANALYTICS_ENABLE_IN_JS de true en su config.xml

<preference name="APPCENTER_ANALYTICS_ENABLE_IN_JS" value="true" />

Esto significa que, para que cualquier información que se envíe a App Center (incluso la información básica de la sesión), el desarrollador primero debe habilitar App Center Analytics dentro de la aplicación agregando la siguiente línea a su código.

var success = function() {
    console.log("analytics disabled");
}

var error = function(error) {
    console.error(error);
}

AppCenter.Analytics.setEnabled(true, success, error);

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 para los nuevos registros. Una vez que el dispositivo devuelva el acceso a Internet, el SDK enviará registros en el lote de 50 o después de cada 3 segundos.

Procesamiento por lotes de registros de eventos

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 3 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 intenta el máximo por solicitud.
• Cada solicitud tiene su propia máquina de estado de reintento.
• Todos los canales de transmisión están deshabilitados (hasta el siguiente proceso de aplicación) después de que una solicitud agote todos sus reintentos.

Lógica de retroceso

• 50 % de 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 desde wi-fi a móvil), los estados de reintento se restablecen y las solicitudes se reintentan inmediatamente.