Dane zbierane przez zestawy SDK centrum aplikacji

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Mimo że możesz nadal używać programu Visual Studio App Center do momentu jej pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

Zestawy SDK usługi App Center wysyłają dane do usług App Center. Dane wysyłane różnią się w zależności od używanego zestawu SDK/usługi, sposobu konfigurowania zestawu SDK i usługi awaryjnej na danych obsługiwanych przez aplikację. Użycie niektórych usług wymaga, aby niektóre dane zostały wysłane w celu działania usługi. Wszystkie dane wysyłane do centrum aplikacji są przesyłane za pośrednictwem centralnej usługi pozyskiwania.

Typowe dane

Dane wysyłane za pośrednictwem nagłówków żądań z zestawu SDK do pozyskiwania danych

Wymagane dane — App-Secret, Install-ID

  • Wpis tajny aplikacji (App-Secret) Unikatowy klucz używany do identyfikowania aplikacji.

  • Identyfikator instalacji (identyfikator instalacji) Każda instalacja aplikacji z zestawem SDK centrum aplikacji powoduje utworzenie nowego, unikatowego identyfikatora instalacji. Ten identyfikator służy do rozróżniania danych od unikatowych urządzeń. Usługi App Center wymagają prawidłowego działania identyfikatora.

Dane wysyłane za pośrednictwem treści żądania z zestawu SDK do pozyskiwania

Wymagane dane — sdkName, sdkVersion, osName, osVersion, ustawienia regionalne, timeZoneOffset, appVersion, appBuild

  • Sygnatura czasowa (sygnatura czasowa) Sygnatura czasowa dziennika, przykład: "2017-03-13T18:05:42Z"

  • Identyfikator sesji (sid) Dzienniki analizy mogą być częścią tej samej sesji, określając ten identyfikator.

  • Identyfikator użytkownika (userId) Opcjonalny ciąg używany do kojarzenia dzienników z użytkownikami.

  • Nazwa zestawu SDK (sdkName) Nazwa zestawu SDK. Składa się z nazwy zestawu SDK i platformy, np. "appcenter.ios", "hockeysdk.android"

  • Wersja zestawu SDK (sdkVersion) Wersja zestawu SDK w formacie semver, np. "1.2.0" lub "0.12.3-alpha.1"

  • Wersja otoki zestawu SDK (otokaSdkVersion) Wersja zestawu SDK otoki w formacie semver. Gdy zestaw SDK opakowuje podstawowy zestaw SDK, wersja zestawu SDK opakowującego jest przechwytywana w tym polu, podczas gdy podstawowa wersja zestawu SDK to sdkVersion. Na przykład platforma Xamarin.Android opakowuje natywny system Android.

  • Nazwa otoki zestawu SDK (otokaSdkName) Nazwa zestawu SDK otoki. Składa się z nazwy zestawu SDK i platformy otoki, np. "appcenter.xamarin", "hockeysdk.cordova".

  • Model (model) Model urządzenia (na przykład: iPad2,3)

  • Nazwa producenta OEM (oemName) Nazwa producenta urządzenia (na przykład: HTC)

  • Nazwa systemu operacyjnego (osName) Nazwa systemu operacyjnego (przykład: iOS)

  • Wersja systemu operacyjnego (osVersion) Wersja systemu operacyjnego (przykład: 9.3.0)

  • Kod kompilacji systemu operacyjnego (osBuild) Kod kompilacji systemu operacyjnego (przykład: LMY47X)

  • Poziom interfejsu API systemu operacyjnego (osApiLevel) Poziom interfejsu API, jeśli ma to zastosowanie w systemie Android (na przykład: 15)

  • Język i kod kraju (ustawienia regionalne) Język ISO i kod kraju (na przykład: en-US)

  • Przesunięcie strefy czasowej (timeZoneOffset) Przesunięcie w minutach od czasu UTC dla strefy czasowej urządzenia, w tym czas letni.

  • Rozmiar ekranu (screenSize) Rozmiar ekranu urządzenia w pikselach (na przykład 640x480).

  • Wersja aplikacji (appVersion) Wersja aplikacji zwykle w wersji głównej, pomocniczej, kompilacji (na przykład: 1.1.42)

  • Nazwa przewoźnika (carrierName) Nazwa dostawcy usług komórkowych.

  • Carrier Country (carrierCountry) Kraj dostawcy usług komórkowych.

  • Kompilacja aplikacji (appBuild) Numer kompilacji aplikacji. (przykład: 42)

  • Przestrzeń nazw aplikacji (appNamespace) Identyfikator pakietu, identyfikator pakietu lub przestrzeń nazw, w zależności od używanej przez poszczególne platformy (na przykład: com.microsoft.example)

  • Live Update Release Label (liveUpdateReleaseLabel) Etykieta używana do identyfikowania kodu aplikacji "version" wydanego za pośrednictwem sygnału nawigacyjnego live update uruchomionego na urządzeniu.

  • Klucz wdrożenia aktualizacji na żywo (liveUpdateDeploymentKey) Identyfikator środowiska, do którego należy bieżąca wersja aplikacji, klucz wdrożenia, a następnie mapuje środowisko, takie jak Produkcja, Przejściowe

  • Skrót pakietu aktualizacji na żywo (liveUpdatePackageHash) Skrót wszystkich plików (ReactNative lub Cordova) wdrożonych na urządzeniu za pośrednictwem sygnału nawigacyjnego LiveUpdate. Pomaga zidentyfikować wersję wydania na urządzeniu lub konieczność pobrania aktualizacji w przyszłości

  • Wersja otoki środowiska uruchomieniowego (wrapperRuntimeVersion) Wersja struktury technologii otoki (wersja środowiska uruchomieniowego platformy Xamarin, ReactNative, Cordova itd.). Zobacz otorsdkname, aby sprawdzić, czy ta wersja odnosi się do platformy Xamarin lub ReactNative lub innej.

  • Jailbreak (jailbreak) Flaga wskazująca, czy urządzenie zostało zdjęte zabezpieczeń systemu.

Analiza

  • Metryki zaangażowania Zaangażowanie mierzy dzienne sesje na użytkownika i czas trwania sesji.

    • Sesje dzienne na użytkownika: średnia dzienna liczba sesji na użytkownika.

    • Łączna liczba sesji: łączna liczba sesji.

    • Średnia liczba sesji dziennie: liczba sesji dziennie średnia w zakresie czasu.

    • Czas trwania sesji: rozkład liczby sesji w kilku interwałach trwania.

    • Średnia długość sesji: średnia wszystkich czasów trwania sesji w wybranym zakresie czasu.

  • Metryki zdarzeń Możesz śledzić własne metryki zdarzeń z maksymalnie 20 właściwościami, aby zrozumieć interakcję między użytkownikami a aplikacją.

Diagnostyka

  • Dane dzienników awarii i błędów Te dane obejmują identyfikator i nazwę procesów, wątków, ramek związanych z awarią oraz typu wyjątku oraz danych komunikatów i urządzeń zgodnie z definicją w sekcji Common Data

  • Załączniki awaryjne Te załączniki to pliki binarne lub tekstowe, które deweloperzy mogą opcjonalnie dołączyć do raportu o awarii.

  • Właściwości niestandardowe Te niestandardowe pary wartości klucza można opcjonalnie określić, aby dodać dodatkowy kontekst do raportów o błędach.

  • Awaria i błąd Identyfikator użytkownika Ten unikatowy identyfikator jest opcjonalnie ustawiany przez dewelopera w celu dołączenia identyfikacji określonego użytkownika do raportów o awarii.

  • Pliki symboli Te pliki symboli są dostarczane przez dewelopera usługi App Center w celu symbolicznego wystąpienia awarii.

Rozłóż

  • Tokenu Ten identyfikator GUID jest wysyłany do usługi dystrybucji, aby sprawdzić nową wersję aplikacji. Identyfikator GUID jest wysyłany tylko wtedy, gdy aplikacja została zainstalowana przy użyciu centrum aplikacji.