Data shromážděná prostřednictvím SDK App Center

Důležité

Visual Studio App Center bylo vyřazeno 31. března 2025 s výjimkou funkcí Analýzy a diagnostiky, které se budou dál podporovat až do 30. června 2026. Další informace.

App Center SDK odesílají data do služeb App Center. Odesílaná data se liší podle toho, jakou sadu SDK nebo službu používáte, jak je sada SDK nakonfigurována, a v případě chybové služby na základě dat zpracovávaných vaší aplikací. Používání některých služeb vyžaduje, aby se určitá data odeslala, aby služba fungovala. Všechna data odesílaná do App Center procházejí službou centrálního příjmu dat.

Běžná data

Data odesílaná z SDK prostřednictvím hlaviček požadavků do zpracování dat

Povinná data – tajný klíč aplikace, Install-ID

• Tajný kód aplikace (App-Secret) Jedinečný klíč použitý k identifikaci aplikace.

• Identifikátor instalace (Install-ID) Každá instalace aplikace se sadou App Center SDK má za následek nový jedinečný identifikátor instalace. Toto ID slouží k rozliš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 těla požadavku ze sady SDK do zpracování

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

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

• Identifikátor relace (sid) Analytické protokoly můžou být součástí stejné relace zadáním tohoto identifikátoru.

• 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 (sdkVersion) Verze sady SDK ve formátu semver, např. 1.2.0 nebo 0.12.3-alpha.1

• Verze obalového SDK (wrapperSdkVersion) Verze obalového SDK ve formátu sémantické verzování. Když SDK balí základní SDK, v tomto poli se zachytí verze balícího SDK, zatímco základní verze SDK je označena jako sdkVersion. Například Xamarin.Android zabalí 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 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 to možné v Androidu (příklad: 15)

• Kód jazyka a země (nastavení jazykové oblasti) Kód jazyka ISO a země (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: 640x480).

• Verze aplikace (appVersion) Verze aplikace je obvykle uváděna jako hlavní, vedlejší a build verze (příklad: 1.1.42)

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

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

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

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

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

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

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

• Verze modulu obálky runtime (wrapperRuntimeVersion) Verze rámce technologie obálky (verze runtime Xamarin, ReactNative, Cordova atd.) Podívejte se na wrappersdkname a zjistěte, jestli tato verze odkazuje na Xamarin nebo ReactNative nebo jiné.

• Jailbreak (jailbreak) Příznak označující, jestli je zařízení ve jailbreaku.

Analytika

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

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

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

  • Průměrné relace za den: Počet relací za den vyprůměrovaný v časovém rozsahu

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

  • 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 porozuměli interakci mezi uživateli a aplikací.

Diagnostika

• Data protokolů pádů a chyb Tato data zahrnují ID a název procesů, vláken, rámců, souvisejících s pádem, a typem výjimky a zprávou a daty zařízení, jak je definováno v části 'Common Data'.

• Přílohy chybových ukončení Tyto přílohy jsou binární nebo textové soubory, které můžou vývojáři volitelně připojit ke zprávě o chybovém ukončení.

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

• ID uživatele pro pády a chyby Tento jedinečný identifikátor může vývojář volitelně nastavit, aby připojil identifikaci konkrétního uživatele ke zprávám o pádu aplikací.

• Soubory symbolů Tyto soubory symbolů poskytuje vývojář pro App Center k symbolickému chybovému ukončení.

Distribuovat

• Token Tento identifikátor GUID se odešle distribuční službě ke kontrole nové verze aplikace. Identifikátor GUID se odešle jenom v případě, že byla aplikace nainstalována pomocí App Center.