Data shromažďovaná sadami App Center SDK

Důležité

Visual Studio App Center je naplánované k vyřazení na 31. března 2025. I když můžete Visual Studio App Center dál používat, dokud ho úplně nevyřadíte, existuje několik doporučených alternativ, na které můžete migraci zvážit.

Přečtěte si další informace o časových osách a alternativách podpory.

Sady App Center SDK odesílají data do služeb App Center. Odesílaná data se liší podle použité sady SDK nebo služby, způsobu konfigurace sady SDK a služby chybového ukončení na datech zpracovávaných vaší aplikací. Používání některých služeb vyžaduje odeslání určitých dat, aby služba fungovala. Všechna data odesílaná do App Center procházejí službou centrálního příjmu dat.

Společná data

Data odesílaná prostřednictvím hlaviček požadavků ze sady SDK do příjmu dat

Povinná data – tajný kód aplikace, ID instalace

  • Tajný kód aplikace (tajný kód aplikace) Jedinečný klíč, který slouží k identifikaci aplikace.

  • Identifikátor instalace (Install-ID) Každá instalace aplikace pomocí sady App Center SDK má za následek nový jedinečný identifikátor instalace. Toto ID slouží k odlišení dat od jedinečných zařízení. Služby App Center vyžadují, aby ID fungovalo správně.

Data odesílaná prostřednictvím textu požadavku ze sady SDK do příjmu dat

Povinná data – sdkName, sdkVersion, osName, osVersion, národní prostředí, timeZoneOffset, appVersion, appBuild

  • Časové razítko (časové razítko) Časové razítko protokolu, příklad: '2017-03-13T18:05:42Z'

  • Identifikátor relace (SID) Zadáním tohoto identifikátoru můžou být protokoly analýzy součástí stejné relace.

  • Identifikátor uživatele (userId) Volitelný řetězec používaný k přidružení protokolů k uživatelům.

  • Název sady SDK (sdkName) Název sady SDK. Skládá se z názvu sady SDK a platformy, například appcenter.ios, hockeysdk.android.

  • Verze sady SDK (verze sady SDK) Verze sady SDK ve formátu semver, například 1.2.0 nebo 0.12.3-alpha.1

  • Verze obálky SADY SDK (wrapperSdkVersion) Verze sady SDK obálky ve formátu semver. Když sada SDK zabalí základní sadu SDK, zaznamená se do tohoto pole zabalená verze sady SDK, zatímco základní verze sady SDK je sdkVersion. Například Xamarin.Android zabaluje nativní Android.

  • Název obálky sady SDK (wrapperSdkName) Název obálkové sady SDK. Skládá se z názvu sady SDK a obálkové platformy, například appcenter.xamarin, hockeysdk.cordova.

  • Model (model) Model zařízení (příklad: iPad2,3)

  • Název výrobce OEM (oemName) Název výrobce zařízení (příklad: HTC)

  • Název operačního systému (osName) Název operačního systému (příklad: iOS)

  • Verze operačního systému (osVersion) Verze operačního systému (příklad: 9.3.0)

  • Kód sestavení operačního systému (osBuild) Kód sestavení operačního systému (příklad: LMY47X)

  • Úroveň rozhraní API operačního systému (osApiLevel) Úroveň rozhraní API, pokud je k dispozici jako v Androidu (příklad: 15)

  • Jazyk a kód země (národní prostředí) Kód jazyka a země ISO (příklad: en-US)

  • Posun časového pásma (timeZoneOffset) Posun v minutách od UTC pro časové pásmo zařízení, včetně letního času.

  • Velikost obrazovky (velikost obrazovky) Velikost obrazovky zařízení v pixelech (příklad: 640 × 480).

  • Verze aplikace (appVersion) Verze aplikace obvykle v hlavním, podverzi, sestavení (příklad: 1.1.42)

  • Název operátora (carrierName) Název poskytovatele mobilních služeb.

  • Země dopravce (carrierCountry) Země poskytovatele mobilních služeb.

  • Sestavení aplikace (appBuild) Číslo sestavení aplikace. (příklad: 42)

  • Obor názvů aplikace (appNamespace) Identifikátor sady prostředků, identifikátor balíčku nebo obor názvů v závislosti na tom, co jednotlivá platforma používá (příklad: com.microsoft.example)

  • Popisek vydání živé aktualizace (liveUpdateReleaseLabel) Popisek, který se používá k identifikaci kódu aplikace "verze" vydaného prostřednictvím signálu Live Update běžícího na zařízení.

  • Live Update Deployment Key (liveUpdateDeploymentKey) Identifikátor prostředí, do kterého aktuální verze aplikace patří, klíč nasazení se pak mapuje na prostředí, jako je Production, Staging.

  • Hodnota hash balíčku aktualizace live (liveUpdatePackageHash) Hodnota hash všech souborů (ReactNative nebo Cordova) nasazených do zařízení prostřednictvím signálu LiveUpdate. Pomáhá identifikovat vydanou verzi na zařízení nebo potřebu stahovat aktualizace v budoucnu.

  • Verze obálky modulu runtime (wrapperRuntimeVersion) Verze architektury technologie obálky (verze modulu runtime Xamarin, ReactNative, Cordova atd.) Pokud chcete zjistit, jestli tato verze odkazuje na Xamarin, ReactNative nebo jiné, podívejte se na wrappersdkname.

  • Jailbreak (jailbreak) Příznak označující, jestli má zařízení jailbreak.

Analýzy

  • Metriky zapojení Zapojení měří denní relace na uživatele a dobu trvání relace.

    • Denní relace na uživatele: Průměrný denní počet relací na uživatele.

    • Celkový počet relací: Celkový počet relací.

    • Průměrný počet relací za den: Počet relací za den zprůměrovaný v rámci časového rozsahu.

    • Doba trvání relace: Rozdělení počtu relací v několika časových intervalech.

    • Průměrná délka relace: Průměr všech dob trvání relace ve vybraném časovém rozsahu.

  • Metriky událostí Můžete sledovat vlastní metriky událostí s až 20 vlastnostmi, abyste pochopili interakci mezi uživateli a aplikací.

Diagnostika

  • Data protokolů chyb a chyb Tato data zahrnují ID a názvy procesů, vláken, rámců souvisejících s chybou a typ výjimky a zprávu a data zařízení, jak jsou definovány v části Společná data.

  • Přílohy k chybám Tyto přílohy jsou binární nebo textové soubory, které mohou vývojáři volitelně připojit ke zprávě o chybách.

  • Vlastní vlastnosti Tyto vlastní páry hodnot klíčů je možné volitelně zadat, aby se do jejich zpráv o chybách přidal další kontext.

  • ID uživatele chybového ukončení a chyby Tento jedinečný identifikátor je volitelně nastaven vývojářem, aby připojil identifikaci konkrétního uživatele k zprávám o chybách.

  • Soubory symbolů Tyto soubory symbolů poskytuje vývojář app center, aby symbolizoval chybové ukončení.

Rozmístit

  • Token Tento identifikátor GUID se odešle distribuční službě, aby se zkontrolovala nová verze aplikace. Identifikátor GUID se odešle jenom v případě, že se aplikace nainstalovala pomocí App Center.