Compartir a través de


Datos recopilados por los SDK de App Center

Importante

Visual Studio App Center se retiró el 31 de marzo de 2025, excepto las características de análisis y diagnóstico, que seguirán siendo compatibles hasta el 30 de junio de 2026. Más información.

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 utilice, cómo se configure un SDK, y para el servicio de fallos, dependiendo de los datos que maneje su aplicación. El uso de algunos servicios requiere que se envíen determinados datos para que funcione el servicio. 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 al Sistema de Ingestión

Datos necesarios – secreto de aplicación, 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 Ingestión

Datos necesarios - sdkName, sdkVersion, osName, osVersion, configuración regional, desfase de zona horaria, 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 SDK de envoltura (wrapperSdkName) El nombre del SDK de envoltura. Consta del nombre del SDK y la plataforma contenedora, por ejemplo, "appcenter.xamarin", "hockeysdk.cordova".

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

  • Nombre de OEM (oemName) 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 del sistema operativo (osApiLevel) Nivel de API cuando sea 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 desde 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 suele estar en formato mayor, menor, compilación (por ejemplo: 1.1.42)

  • Nombre del operador (carrierName) El nombre del proveedor de servicios de telefonía móvil.

  • País del operador (carrierCountry) El país del proveedor de servicios móviles.

  • 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)

  • Etiqueta de lanzamiento de actualización en vivo (liveUpdateReleaseLabel) La etiqueta utilizada para identificar la "versión" del código de aplicación lanzada a través de la baliza de Actualización en Vivo 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; a continuación, la clave de implementación se asigna a un entorno como Producción o Preproducción.

  • Hash del paquete de actualización en vivo (liveUpdatePackageHash) Un hash de todos los archivos (ReactNative y Cordova) desplegados en el dispositivo mediante la baliza LiveUpdate. Ayuda a identificar la versión de lanzamiento en el dispositivo o la necesidad de descargar actualizaciones en el futuro.

  • Versión del contenedor en tiempo de ejecución (wrapperRuntimeVersion) La versión del marco de tecnología contenedora (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) Una marca que indica si el dispositivo ha sido rooteado.

Análisis de datos

  • Métricas de engagement La interacción 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ósticos

  • Datos de registros de errores y bloqueos 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 de mensaje y dispositivo, tal como se define en la sección Datos comunes.

  • Archivos adjuntos de bloqueos Estos archivos adjuntos son archivos binarios o de texto que los desarrolladores pueden adjuntar a un informe de bloqueo de forma opcional.

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

  • Identificador de usuario de bloqueo y error Este identificador único se establece opcionalmente por el desarrollador para adjuntar la identificación de un usuario específico a los informes de bloqueo y error.

  • Archivos de símbolos Estos archivos de símbolos son proporcionados por el desarrollador para que App Center pueda simbolizar accidentes.

Distribuir

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