Datos recopilados por los SDK de App Center

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.

Los SDK de App Center envían datos a los servicios de App Center. Los datos enviados varían según el SDK o el servicio que se usa, cómo se configura un SDK y, para el servicio de bloqueo, en los datos administrados por la aplicación. El uso de algunos servicios requiere que se envíen determinados datos para que el servicio funcione. Todos los datos enviados a App Center viajan a través de un servicio de ingesta central.

Datos comunes

Datos enviados a través de encabezados de solicitud del SDK a la ingesta

Datos necesarios : App-Secret, Install-ID

  • Secreto de aplicación (App-Secret) Clave única que se usa para identificar la aplicación.

  • Identificador de instalación (Install-ID) Cada instalación de una aplicación con un SDK de App Center da como resultado un nuevo identificador de instalación único. Este identificador se usa para diferenciar los datos de los dispositivos únicos. Los servicios de App Center requieren que el identificador funcione correctamente.

Datos enviados a través del cuerpo de la solicitud del SDK a la ingesta

Datos necesarios : sdkName, sdkVersion, osName, osVersion, configuración regional, timeZoneOffset, appVersion, appBuild

  • Marca de tiempo (marca de tiempo) Marca de tiempo de registro, ejemplo: "2017-03-13T18:05:42Z"

  • Identificador de sesión (sid) Los registros de análisis pueden formar parte de la misma sesión especificando este identificador.

  • Identificador de usuario (userId) Cadena opcional que se usa para asociar registros a los usuarios.

  • Nombre del SDK (sdkName) Nombre del SDK. Consta del nombre del SDK y de la plataforma, por ejemplo, "appcenter.ios", "hockeysdk.android"

  • Versión del SDK (sdkVersion) La versión del SDK en formato semver, por ejemplo, "1.2.0" o "0.12.3-alpha.1".

  • Versión del contenedor del SDK (wrapperSdkVersion) La versión del SDK contenedor en formato semver. Cuando el SDK encapsula un SDK base, la versión del SDK de ajuste se captura en este campo mientras que la versión del SDK base es sdkVersion. Por ejemplo, Xamarin.Android encapsula Android nativo.

  • Nombre del contenedor del SDK (wrapperSdkName) Nombre del SDK contenedor. Consta del nombre del SDK y de la plataforma contenedora, por ejemplo, "appcenter.xamarin", "hockeysdk.cordova".

  • Modelo (modelo) El modelo de dispositivo (ejemplo: iPad2,3)

  • Nombre de OEM (oemName) El nombre del fabricante del dispositivo (ejemplo: HTC)

  • Nombre del sistema operativo (osName) Nombre del sistema operativo (ejemplo: iOS)

  • Versión del sistema operativo (osVersion) Versión del sistema operativo (ejemplo: 9.3.0)

  • Código de compilación del sistema operativo (osBuild) Código de compilación del sistema operativo (ejemplo: LMY47X)

  • Nivel de API de sistema operativo (osApiLevel) Nivel de API cuando es aplicable como en Android (ejemplo: 15)

  • Idioma y código de país (configuración regional) Idioma ISO y código de país (ejemplo: en-US)

  • Desplazamiento de zona horaria (timeZoneOffset) Desplazamiento en minutos de utc para la zona horaria del dispositivo, incluido el horario de verano.

  • Tamaño de pantalla (screenSize) Tamaño de la pantalla del dispositivo en píxeles (ejemplo: 640x480).

  • Versión de la aplicación (appVersion) La versión de la aplicación normalmente en la compilación principal y secundaria (por ejemplo: 1.1.42)

  • Nombre del operador (carrierName) Nombre del proveedor de servicios de celda.

  • País del transportista (carrierCountry) País del proveedor de servicios de celda.

  • Compilación de aplicaciones (appBuild) Número de compilación de la aplicación. (ejemplo: 42)

  • Espacio de nombres de aplicación (appNamespace) Identificador de agrupación, identificador de paquete o espacio de nombres, en función de lo que use la plataforma individual (ejemplo: com.microsoft.example)

  • Live Update Release Label (liveUpdateReleaseLabel) Etiqueta que se usa para identificar el código de aplicación "versión" publicado a través de la baliza Live Update que se ejecuta en el dispositivo.

  • Clave de implementación de Live Update (liveUpdateDeploymentKey) El identificador del entorno al que pertenece la versión actual de la aplicación, la clave de implementación se asigna a un entorno como Producción, Ensayo

  • Hash de paquete de actualización dinámica (liveUpdatePackageHash) Hash de todos los archivos (ReactNative o Cordova) implementados en el dispositivo a través de la baliza liveUpdate. Ayuda a identificar la versión de lanzamiento en el dispositivo o necesita descargar actualizaciones en el futuro.

  • Versión del contenedor en tiempo de ejecución (wrapperRuntimeVersion) La versión del marco de tecnología del contenedor (versión en tiempo de ejecución de Xamarin, ReactNative, Cordova, etc.). Consulte wrappersdkname para ver si esta versión hace referencia a Xamarin o ReactNative u otros.

  • Jailbreak (jailbreak) Marca que indica si el dispositivo se ha liberado.

Análisis

  • Métricas de interacción Engagement mide las sesiones diarias por usuario y duración de la sesión.

    • Sesiones diarias por usuario: número medio diario de sesiones por usuario.

    • Total de sesiones: número total de sesiones.

    • Promedio de sesiones por día: número de sesiones por día promedio a lo largo del intervalo de tiempo.

    • Duración de la sesión: distribución del número de sesiones durante unos intervalos de duración.

    • Duración media de la sesión: promedio de todas las duraciones de sesión en el intervalo de tiempo seleccionado.

  • Métricas de eventos Puede realizar un seguimiento de sus propias métricas de eventos con hasta 20 propiedades para comprender la interacción entre los usuarios y la aplicación.

Diagnóstico

  • Datos de registros de bloqueos y errores Estos datos incluyen el identificador y el nombre de los procesos, subprocesos, marcos, relacionados con el bloqueo y el tipo de excepción y los datos del mensaje y del dispositivo, tal como se define en la sección Datos comunes.

  • Datos adjuntos de bloqueo Estos datos adjuntos son archivos binarios o de texto que los desarrolladores pueden adjuntar opcionalmente a un informe de bloqueo.

  • Propiedades personalizadas Estos pares clave-valor personalizados se pueden especificar opcionalmente para agregar contexto adicional a sus informes de errores.

  • Identificador de usuario de bloqueo y error Opcionalmente, el desarrollador establece este identificador único para adjuntar la identificación del usuario específico a los informes de bloqueo.

  • Archivos de símbolos El desarrollador de App Center proporciona estos archivos de símbolos para que se bloqueen.

Distribución

  • Token Este GUID se envía al servicio de distribución para comprobar una nueva versión de la aplicación. El GUID solo se envía si la aplicación se instaló mediante App Center.