Partager via


Données collectées par le SDK de l'App Center

Important

Visual Studio App Center a été mis hors service le 31 mars 2025, à l’exception des fonctionnalités d’analyse et de diagnostic, qui continueront d’être prises en charge jusqu’au 30 juin 2026. En savoir plus.

Les kits SDK App Center envoient des données aux services App Center. Les données envoyées varient selon le service ou SDK utilisé, la manière dont un SDK est configuré, et, pour le service de gestion des incidents, selon les données gérées par votre application. L’utilisation de certains services nécessite que certaines données soient envoyées pour que le service fonctionne. Toutes les données envoyées à App Center transitent par le biais d’un service d’ingestion central.

Données courantes

Données envoyées par le biais d’en-têtes de requête du SDK au système d'ingestion

Données requises : App-Secret, Install-ID

  • Secret d’application (App-Secret) Clé unique utilisée pour identifier l’application.

  • Identificateur d’installation (Install-ID) Chaque installation d’une application avec un Kit de développement logiciel (SDK) App Center entraîne un nouvel identificateur d’installation unique. Cet ID est utilisé pour différencier les données des appareils uniques. Les services App Center nécessitent que l’ID fonctionne correctement.

Données envoyées par le biais du corps de la demande du KIT de développement logiciel (SDK) à l’ingestion

Données requises - sdkName, sdkVersion, osName, osVersion, paramètres régionaux, timeZoneOffset, appVersion, appBuild

  • Horodatage (horodatage) Marque temporelle du journal, exemple : « 2017-03-13T18:05:42Z »

  • Identificateur de session (sid) Les journaux d'Analytics peuvent être inclus dans la même session en spécifiant cet identificateur.

  • Identificateur d’utilisateur (userId) Chaîne facultative utilisée pour associer des journaux de log à des utilisateurs.

  • Nom du Kit de développement logiciel (sdkName) Nom du Kit de développement logiciel (SDK). Se compose du nom du Kit de développement logiciel (SDK) et de la plateforme, par exemple « appcenter.ios », « hockeysdk.android »

  • Version du Kit de développement logiciel (SDKVersion) Version du SDK au format semver, par exemple « 1.2.0 » ou « 0.12.3-alpha.1 »

  • Version du wrapper SDK (wrapperSdkVersion) La version du wrapper du Kit de développement logiciel (SDK) au format semver. Lorsque le Kit de développement logiciel (SDK) encapsule un SDK de base, la version du Kit de développement logiciel (SDK) encapsulée est capturée dans ce champ, tandis que la version du Kit de développement logiciel (SDK) de base est sdkVersion. Par exemple, Xamarin.Android encapsule Android natif.

  • Nom du SDK wrapper (wrapperSdkName) Le nom du SDK wrapper. Se compose du nom du SDK et de la plateforme wrapper, par exemple « appcenter.xamarin », « hockeysdk.cordova ».

  • Modèle (modèle) Modèle d’appareil (exemple : iPad2,3)

  • Nom OEM (oemName) Nom du fabricant de l’appareil (exemple : HTC)

  • Nom du système d’exploitation (osName) Nom du système d’exploitation (exemple : iOS)

  • Version du système d’exploitation (osVersion) Version du système d’exploitation (exemple : 9.3.0)

  • Code de build du système d’exploitation (osBuild) Code de build du système d’exploitation (exemple : LMY47X)

  • Niveau de l’API du système d’exploitation (osApiLevel) Niveau d’API, le cas échéant, comme dans Android (exemple : 15)

  • Langue et code de pays (paramètres régionaux) Langue ISO et code de pays (exemple : en-US)

  • Décalage du fuseau horaire (timeZoneOffset) Le décalage en minutes par rapport à UTC pour le fuseau horaire de l’appareil, y compris l’heure d’été.

  • Taille de l’écran (screenSize) Taille de l’écran de l’appareil en pixels (exemple : 640 x 480).

  • Version de l’application (appVersion) Version de l’application généralement en version majeure, mineure, build (exemple : 1.1.42)

  • Nom de l’opérateur (carrierName) Nom du fournisseur de services de cellule.

  • Pays de l'opérateur (carrierCountry) Le pays du fournisseur de services cellulaires.

  • Build d’application (appBuild) Numéro de build de l’application. (exemple : 42)

  • Espace de noms d’application (appNamespace) Identificateur de bundle, identificateur de package ou espace de noms, en fonction de ce que la plateforme individuelle utilise (exemple : com.microsoft.example)

  • Live Update Release Label (liveUpdateReleaseLabel) Étiquette utilisée pour identifier le code d’application « version » publié via le beacon Live Update en cours d’exécution sur l’appareil.

  • Clé de déploiement Live Update (liveUpdateDeploymentKey) L'identificateur de l'environnement auquel appartient la version actuelle de l'application, où la clé de déploiement est ensuite associée à des environnements tels que Production, Staging.

  • Hachage de paquet Live Update (liveUpdatePackageHash) Hachage de tous les fichiers (ReactNative ou Cordova) déployés sur l’appareil via une balise LiveUpdate. Permet d’identifier la version de sortie sur l’appareil ou la nécessité de télécharger des mises à jour dans le futur.

  • Version de l'enveloppement du runtime (wrapperRuntimeVersion) La version du framework de technologie d'encapsulation (version d'exécution Xamarin, ReactNative, Cordova, etc.). Consultez wrappersdkname pour voir si cette version fait référence à Xamarin ou ReactNative ou autre.

  • Jailbreak (jailbreak) Indicateur indiquant si l’appareil a été jailbroken.

Analyse de données

  • Métriques d’engagement L’engagement mesure les sessions quotidiennes par utilisateur et la durée de session.

    • Sessions quotidiennes par utilisateur : nombre moyen quotidien de sessions par utilisateur.

    • Nombre total de sessions : nombre total de sessions.

    • Sessions moyennes par jour : nombre de sessions par jour moyen sur l’intervalle de temps.

    • Durée de session : distribution du nombre de sessions sur quelques intervalles de durée.

    • Durée moyenne de session : moyenne de toutes les durées de session dans l’intervalle de temps sélectionné.

  • Métriques d’événement Vous pouvez suivre vos propres métriques d’événements avec jusqu’à 20 propriétés pour comprendre l’interaction entre vos utilisateurs et l’application.

Diagnostiques

  • Données sur les incidents et les journaux d’erreurs Ces données incluent l’ID et le nom des processus, des threads, des trames, liés au crash et au type et message d’exception ainsi qu'aux données d'appareil telles que définies dans la section "Common Data".

  • Pièces jointes sur incident Ces pièces jointes sont des fichiers binaires ou texte que les développeurs peuvent éventuellement attacher à un rapport d’incident.

  • Propriétés personnalisées Ces paires de valeurs de clé personnalisées peuvent éventuellement être spécifiées pour ajouter un contexte supplémentaire à leurs rapports d’erreurs.

  • Incident et ID d’utilisateur d’erreur Cet identificateur unique est éventuellement défini par le développeur pour attacher l’identification de l’utilisateur spécifique aux rapports d’incident.

  • Fichiers de symboles Ces fichiers de symboles sont fournis par le développeur pour App Center afin de symboliquer les blocages.

Distribuer

  • Jeton Ce GUID est envoyé au service de distribution pour rechercher une nouvelle version de l’application. Le GUID est envoyé uniquement si l’application a été installée à l’aide d’App Center.