Dati raccolti dagli SDK di App Center

Importante

Visual Studio App Center è stato ritirato il 31 marzo 2025, ad eccezione delle funzionalità di Analisi e diagnostica, che continueranno a essere supportate fino al 30 giugno 2026. Ulteriori informazioni.

Gli SDK di App Center inviano dati ai servizi di App Center. I dati inviati variano in base all'SDK/servizio usato, alla configurazione di un SDK e, per il servizio di arresto anomalo, sui dati gestiti dall'applicazione. L'utilizzo di alcuni servizi richiede l'invio di determinati dati affinché il servizio funzioni. Tutti i dati inviati ad App Center passano attraverso un servizio di inserimento centrale.

Dati comuni

Dati inviati tramite header di richiesta dall'SDK all'ingestione

Dati obbligatori - App-Secret, Install-ID

• Segreto dell'applicazione (App-Secret) Chiave univoca usata per identificare l'applicazione.

• Identificatore di installazione (Install-ID) Ogni installazione di un'app con un SDK di App Center genera un nuovo identificatore di installazione univoco. Questo ID viene usato per distinguere i dati dai dispositivi univoci. I servizi di App Center richiedono che l'ID funzioni correttamente.

Dati inviati dal corpo della richiesta dall'SDK al sistema di ingestione

Dati necessari - sdkName, sdkVersion, osName, osVersion, impostazioni locali, timeZoneOffset, appVersion, appBuild

• Timestamp (timestamp) Timestamp del log, ad esempio: '2017-03-13T18:05:42Z'

• Identificatore sessione (sid) I log di analisi possono far parte della stessa sessione specificando questo identificatore.

• Identificatore utente (userId) Stringa facoltativa usata per associare i log agli utenti.

• Nome SDK (sdkName) Nome dell'SDK. È costituito dal nome dell'SDK e dalla piattaforma, ad esempio "appcenter.ios", "hockeysdk.android"

• Versione SDK (sdkVersion) Versione dell'SDK in formato semver, ad esempio "1.2.0" o "0.12.3-alpha.1"

• Versione wrapper SDK (wrapperSdkVersion) La versione del wrapper SDK nel formato semver. Quando l'SDK esegue il wrapping di un SDK di base, la versione dell'SDK di wrapping viene acquisita in questo campo mentre la versione dell'SDK di base è sdkVersion. Ad esempio, Xamarin.Android integra Android nativo.

• Nome del wrapper SDK (wrapperSdkName) Il nome del SDK wrapper. È costituito dal nome dell'SDK e dalla piattaforma wrapper, ad esempio "appcenter.xamarin", "hockeysdk.cordova".

• Modello (modello) Modello di dispositivo (ad esempio: iPad2,3)

• Nome OEM (oemName) Nome del produttore del dispositivo (ad esempio: HTC)

• Nome sistema operativo (osName) Nome del sistema operativo (esempio: iOS)

• Versione del sistema operativo (osVersion) Versione del sistema operativo (esempio: 9.3.0)

• Codice di compilazione del sistema operativo (osBuild) Codice di compilazione del sistema operativo (esempio: LMY47X)

• Livello API del sistema operativo (osApiLevel) Livello API quando applicabile in Android (ad esempio: 15)

• Lingua e codice paese (impostazioni locali) Codice paese e lingua ISO (ad esempio: en-US)

• Offset del fuso orario (timeZoneOffset) L'offset in minuti rispetto all'ora UTC per il fuso orario del dispositivo, includendo l'ora legale.

• Dimensioni schermo (screenSize) Dimensioni dello schermo del dispositivo in pixel (ad esempio: 640x480).

• Versione dell'applicazione (appVersion) La versione dell'applicazione, tipicamente composta da numeri in formato: versione principale, secondaria, costruzione (esempio: 1.1.42)

• Nome operatore (carrierName) Nome del provider di servizi di telefonia mobile.

• Paese operatore (carrierCountry) Il paese del provider di servizi di telefonia mobile.

• Compilazione dell'applicazione (appBuild) Numero di build dell'app. (esempio: 42)

• Spazio dei nomi dell'applicazione (appNamespace) Identificatore del bundle, identificatore del pacchetto o spazio dei nomi, a seconda di ciò che usa la singola piattaforma (ad esempio: com.microsoft.example)

• Live Update Release Label (liveUpdateReleaseLabel) Etichetta usata per identificare la 'versione' del codice dell'applicazione rilasciato tramite il beacon Live Update in esecuzione sul dispositivo.

• Live Update Deployment Key (liveUpdateDeploymentKey) L'identificatore dell'ambiente a cui appartiene la versione corrente dell'applicazione, la chiave di distribuzione viene quindi mappata all'ambiente, ad esempio Produzione, Gestione temporanea

• Live Update Package Hash (liveUpdatePackageHash) Hash di tutti i file (ReactNative o Cordova) distribuiti nel dispositivo tramite LiveUpdate beacon. Consente di identificare la versione di rilascio nel dispositivo o di dover scaricare gli aggiornamenti in futuro

• Versione del wrapper di runtime (wrapperRuntimeVersion) Versione del framework di tecnologia wrapper (versione del runtime Xamarin, ReactNative, Cordova e così via). Vedere wrappersdkname per verificare se questa versione fa riferimento a Xamarin o ReactNative o altro.

• Jailbreak (jailbreak) Indicatore che indica se il dispositivo è stato sbloccato.

Analisi dei dati

• Metriche di engagement Engagement misura le sessioni giornaliere per utente e durata della sessione.

  • Sessioni giornaliere per utente: numero medio giornaliero di sessioni per utente.

  • Totale sessioni: numero totale di sessioni.

  • Sessioni medie al giorno: numero di sessioni al giorno mediate nell'intervallo di tempo.

  • Durata sessione: distribuzione del numero di sessioni in pochi intervalli di durata.

  • Lunghezza media della sessione: media di tutte le durate della sessione nell'intervallo di tempo selezionato.

• Metriche degli eventi È possibile tenere traccia delle metriche degli eventi con un massimo di 20 proprietà per comprendere l'interazione tra gli utenti e l'app.

Diagnostica

• Dati dei log degli arresti anomali e degli errori Questi dati includono l'ID e il nome di processi, thread, frame, correlati all'arresto anomalo e al tipo di eccezione e ai dati del dispositivo, come definito nella sezione Dati comuni

• Allegati di arresto anomalo Questi allegati sono file binari o di testo che gli sviluppatori possono eventualmente allegare a un report di arresto anomalo del sistema.

• Proprietà personalizzate Queste coppie chiave-valore personalizzate possono essere specificate facoltativamente per aggiungere contesto aggiuntivo alle relative segnalazioni errori.

• ID utente di segnalazione di errori e arresti anomali Questo identificatore univoco è facoltativamente impostato dallo sviluppatore per allegare l'identificazione di un utente specifico ai report sugli arresti anomali.

• File di simboli Questi file di simboli vengono forniti dallo sviluppatore per App Center per simbolicare gli arresti anomali.

Distribuire

• Token Questo GUID viene inviato al servizio di distribuzione per verificare la presenza di una nuova versione dell'applicazione. Il GUID viene inviato solo se l'applicazione è stata installata con App Center.