Udostępnij przez


Dane zbierane przez SDK App Center

Ważne

Program Visual Studio App Center został wycofany 31 marca 2025 r. z wyjątkiem funkcji analizy i diagnostyki, które będą nadal obsługiwane do 30 czerwca 2026 r. Dowiedz się więcej.

Zestawy SDK App Center wysyłają dane do usług App Center. Wysyłane dane różnią się w zależności od używanego zestawu SDK/usługi, sposobu konfigurowania zestawu SDK, a w przypadku usługi dotyczącej awarii - od danych obsługiwanych przez aplikację. Użycie niektórych usług wymaga, aby niektóre dane zostały wysłane, aby usługa działała. 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 pakietu SDK do przetwarzania.

Wymagane dane — app-secret, Install-ID

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

  • Identyfikator instalacji (Install-ID) Każda instalacja aplikacji z zestawem SDK centrum aplikacji powoduje utworzenie nowego, unikatowego identyfikatora instalacji. Ten identyfikator służy do odróżnienia danych od unikatowych urządzeń. Usługi App Center wymagają identyfikatora, aby działał prawidłowo.

Dane wysyłane przez teść zapytania z SDK do Ingestia.

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

  • Sygnatura czasowa (sygnatura czasowa) Sygnatura czasowa logu, 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 opakowania SDK (wrapperSdkVersion) Wersja opakowania SDK 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 opakowania zestawu SDK (wrapperSdkName) Nazwa opakowania zestawu SDK. Składa się z nazwy zestawu SDK i platformy opakowania, np. "appcenter.xamarin", "hockeysdk.cordova".

  • Model (model) Model urządzenia (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 zastosowanie, na przykład w systemie Android (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 UTC dla strefy czasowej urządzenia, uwzględniając czas letni.

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

  • Wersja aplikacji (appVersion) Wersja aplikacji zazwyczaj składająca się z wersji głównej, wersji drugorzędnej oraz numeru 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 aplikacji lub przestrzeń nazw, w zależności od używanej przez poszczególne platformy (na przykład: com.microsoft.example)

  • Etykieta wydania aktualizacji na żywo (liveUpdateReleaseLabel) Etykieta używana do identyfikowania kodu aplikacji 'version' wydanego za pośrednictwem sygnału aktualizacyjnego 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 następnie odpowiada środowisku, takiemu jak Produkcja, Środowisko testowe

  • Skrót pakietu aktualizacji na żywo (liveUpdatePackageHash) Skrót wszystkich plików (ReactNative lub Cordova) wdrożonych do urządzenia za pomocą beacona LiveUpdate. Pomaga zidentyfikować wersję wydania na urządzeniu lub konieczność pobierania aktualizacji w przyszłości

  • Wersja opakowania środowiska uruchomieniowego (wrapperRuntimeVersion) Wersja struktury technologii opakowania, takiej jak w przypadku środowiska uruchomieniowego Xamarin, ReactNative, Cordova itd. Zobacz wrappersdkname, aby sprawdzić, czy ta wersja odnosi się do platformy Xamarin lub ReactNative lub innej.

  • Jailbreak (jailbreak) Flaga wskazująca, czy urządzenie zostało poddane jailbreakowi.

Analiza danych

  • 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 na dzień: Liczba sesji na dzień uśredniona względem zakresu 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 typ wyjątku oraz dane 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łączać 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ą udostępniane przez dewelopera dla centrum aplikacji w celu symbolicznego wystąpienia awarii.

Rozdziel

  • Token Ten identyfikator GUID jest wysyłany do usługi dystrybucji, aby sprawdzić, czy jest dostępna nowa wersja aplikacji. Identyfikator GUID jest wysyłany tylko wtedy, gdy aplikacja została zainstalowana przy użyciu Centrum aplikacji.