Share via


Dati raccolti dagli SDK di App Center

Importante

Visual Studio App Center è previsto per il ritiro il 31 marzo 2025. Anche se è possibile continuare a usare Visual Studio App Center fino a quando non viene completamente ritirato, esistono diverse alternative consigliate che è possibile considerare la migrazione a.

Altre informazioni sulle sequenze temporali di supporto e sulle alternative.

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 al servizio di arresto anomalo dei dati gestiti dall'applicazione. L'utilizzo di alcuni servizi richiede l'invio di determinati dati per consentire al servizio di funzionare. Tutti i dati inviati a App Center viaggiano attraverso un servizio di inserimento centrale.

Dati comuni

Dati inviati tramite intestazioni di richiesta da SDK a Inserimento

Dati obbligatori : Segreto app, Install-ID

  • Segreto applicazione (segreto app) Chiave univoca usata per identificare l'applicazione.

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

Dati inviati tramite il corpo della richiesta dall'SDK all'inserimento

Dati obbligatori : sdkName, sdkVersion, osName, osVersion, impostazioni locali, timeZoneOffset, appVersion, appBuild

  • Timestamp (timestamp) Timestamp di 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 della 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) Versione dell'SDK wrapper in formato semver. Quando l'SDK esegue il wrapping di un SDK di base, la versione di wrapping dell'SDK viene acquisita in questo campo mentre la versione dell'SDK di base è sdkVersion. Ad esempio, Xamarin.Android esegue il wrapping di Android nativo.

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

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

  • Nome OEM (oemName) Nome del produttore del dispositivo (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 (esempio: 15)

  • Lingua e codice paese (impostazioni locali) Codice iso e paese (esempio: en-US)

  • Offset fuso orario (timeZoneOffset) Offset in minuti dall'ORA UTC per il fuso orario del dispositivo, incluso l'ora legale.

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

  • Versione dell'applicazione (appVersion) Versione dell'applicazione in genere nella compilazione principale, secondaria, (esempio: 1.1.42)

  • Nome vettore (carrierName) Nome del provider di servizi di cella.

  • Paese del vettore (carrierCountry) Paese del provider di servizi cellulari.

  • Compilazione di applicazioni (appBuild) Numero di compilazione dell'app. (esempio: 42)

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

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

  • Live Update Deployment Key (liveUpdateDeploymentKey) Identificatore dell'ambiente a cui appartiene la versione corrente dell'applicazione, la chiave di distribuzione esegue quindi il mapping all'ambiente come Production, Staging

  • 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 scaricare gli aggiornamenti in futuro

  • Versione di Runtime Wrapper (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) Flag che indica se il dispositivo è stato jailbroken.

Analisi

  • Metriche di engagement L'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 su alcuni intervalli di durata.

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

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

Diagnostica

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

  • Allegati anomali Questi allegati sono file binari o di testo che gli sviluppatori possono collegare facoltativamente a un report di arresto anomalo.

  • Proprietà personalizzate Queste coppie di valori chiave personalizzate possono essere specificate facoltativamente per aggiungere un contesto aggiuntivo ai report degli errori.

  • Id utente di arresto anomalo e errore Questo identificatore univoco è facoltativamente impostato dallo sviluppatore per collegare l'identificazione specifica dell'utente ai report di arresto anomalo.

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

Distribuzione

  • 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 usando App Center.