Freigeben über


Von App Center-SDKs gesammelte Daten

Von Bedeutung

Visual Studio App Center wurde am 31. März 2025 eingestellt, mit Ausnahme der Analyse- und Diagnosefeatures, die bis zum 30. Juni 2026 weiterhin unterstützt werden. Weitere Informationen

App Center-SDKs senden Daten an App Center-Dienste. Die gesendeten Daten variieren abhängig vom verwendeten SDK oder Dienst, der Konfiguration des SDK und, beim Absturzdienst, von den Daten, die Ihre Anwendung verarbeitet. Die Nutzung einiger Dienste erfordert, dass bestimmte Daten gesendet werden, damit der Dienst funktioniert. Alle an Das App Center gesendeten Daten durchlaufen einen zentralen Aufnahmedienst.

Allgemeine Daten

Daten, die über Anforderungsheader von SDK zu Ingestion gesendet werden

Erforderliche Daten – App-Secret, Install-ID

  • Anwendungsgeheimnis (App-Secret) Ein eindeutiger Schlüssel, der zum Identifizieren der Anwendung verwendet wird.

  • Installationsbezeichner (Install-ID) Jede Installation einer App mit einem App Center SDK führt zu einem neuen, eindeutigen Installationsbezeichner. Diese ID wird verwendet, um Daten von eindeutigen Geräten zu unterscheiden. App Center-Dienste erfordern, dass die ID ordnungsgemäß funktioniert.

Daten, die über den Anfrageinhalt vom SDK zur Ingestion gesendet werden

Erforderliche Daten – sdkName, sdkVersion, osName, osVersion, Locale, timeZoneOffset, appVersion, appBuild

  • Zeitstempel (Zeitstempel) Protokollzeitstempel, Beispiel: '2017-03-13T18:05:42Z'

  • Sitzungs-ID (SID) Analyseprotokolle können Teil derselben Sitzung sein, indem sie diesen Bezeichner angeben.

  • Benutzerbezeichner (userId) Eine optionale Zeichenfolge zum Zuordnen von Protokollen zu Benutzern.

  • SDK-Name (sdkName) Der Name des SDK. Besteht aus dem Namen des SDK und der Plattform, z. B. "appcenter.ios", "hockeysdk.android"

  • SDK-Version (sdkVersion) Die Version des SDK im Semver-Format, z. B. "1.2.0" oder "0.12.3-alpha.1"

  • SDK Wrapper-Version (wrapperSdkVersion) Die Version des Wrapper-SDK im Semver-Format. Wenn das SDK ein Basis-SDK umschließt, wird die Umbruch-SDK-Version in diesem Feld erfasst, während die Basis-SDK-Version die sdkVersion ist. Beispielsweise umschließt Xamarin.Android native Android.

  • SDK-Wrappername (WrapperSdkName) Der Name des Wrapper-SDK. Besteht aus dem Namen des SDK und der Wrapperplattform, z. B. "appcenter.xamarin", "hockeysdk.cordova".

  • Modell (Modell) Das Gerätemodell (Beispiel: iPad2,3)

  • OEM-Name (oemName) Der Name des Geräteherstellers (Beispiel: HTC)

  • Betriebssystemname (osName) Betriebssystemname (Beispiel: iOS)

  • Betriebssystemversion (osVersion) Betriebssystemversion (Beispiel: 9.3.0)

  • Betriebssystembuildcode (osBuild) Betriebssystembuildcode (Beispiel: LMY47X)

  • Betriebssystem-API-Ebene (osApiLevel) API-Ebene bei Anwendung wie in Android (Beispiel: 15)

  • Sprache und Ländercode (Locale) ISO-Sprache und Ländercode (Beispiel: en-US)

  • Zeitzonenoffset (TimeZoneOffset) Der Offset in Minuten von UTC für die Gerätezeitzone, einschließlich Sommersparzeit.

  • Bildschirmgröße (screenSize) Die Größe des Gerätebildschirms in Pixeln (Beispiel: 640x480).

  • Anwendungsversion (appVersion) Die Version der Anwendung wird typischerweise in Haupt-, Neben- und Build-Nummern angegeben (Beispiel: 1.1.42)

  • Carrier Name (carrierName) Der Name des Zelldienstanbieters.

  • Carrier Country (carrierCountry) Das Land des Zelldienstanbieters.

  • Anwendungsbuild (appBuild) Die Buildnummer der App. (Beispiel: 42)

  • Anwendungsnamespace (appNamespace) Der Bündelbezeichner, der Paketbezeichner oder der Namespace, je nachdem, was die einzelne Plattform verwendet (Beispiel: com.microsoft.example)

  • Live Update Release Label (liveUpdateReleaseLabel) Die Bezeichnung, die verwendet wird, um den Anwendungscode "Version" zu identifizieren, der über den Live Update-Beacon veröffentlicht wird, der auf dem Gerät ausgeführt wird.

  • Live Update Deployment Key (liveUpdateDeploymentKey) Der Bezeichner der Umgebung, zu der die aktuelle Anwendungsversion gehört, der Bereitstellungsschlüssel wird dann der Umgebung wie "Produktion", "Staging" zugeordnet.

  • Live Update Package Hash (liveUpdatePackageHash) Ein Hash aller Dateien (ReactNative oder Cordova), die über liveUpdate-Beacon auf dem Gerät bereitgestellt werden. Hilft beim Identifizieren der Releaseversion auf dem Gerät oder zum Herunterladen von Updates in Zukunft

  • Runtime Wrapper-Version (wrapperRuntimeVersion) Die Version des Wrapper-Technologieframeworks (Xamarin-Laufzeitversion, ReactNative, Cordova usw.). Sehen Sie sich wrappersdkname an, um festzustellen, ob sich diese Version auf Xamarin oder ReactNative oder andere bezieht.

  • Jailbreak (Jailbreak) Ein Kennzeichen, das angibt, ob das Gerät jailbroken wurde.

Analysen

  • Engagementmetriken Engagement misst die täglichen Sitzungen pro Benutzer und Sitzungsdauer.

    • Tägliche Sitzungen pro Benutzer: Tägliche durchschnittliche Anzahl von Sitzungen pro Benutzer.

    • Gesamtzahl der Sitzungen: Gesamtanzahl der Sitzungen.

    • Durchschnittliche Sitzungen pro Tag: Die Anzahl der Sitzungen pro Tag, die über den Zeitraum gemittelt wurden.

    • Sitzungsdauer: Verteilung der Anzahl der Sitzungen über ein paar Dauerintervalle.

    • Durchschnittliche Sitzungslänge: Durchschnitt aller Sitzungsdauern im ausgewählten Zeitraum.

  • Ereignismetriken Sie können Ihre eigenen Ereignismetriken mit bis zu 20 Eigenschaften nachverfolgen, um die Interaktion zwischen Ihren Benutzern und der App zu verstehen.

Diagnostik

  • Absturz- und Fehlerprotokolldaten Diese Daten umfassen die ID und den Namen von Prozessen, Threads, Frames, im Zusammenhang mit dem Absturz sowie den Ausnahmetyp und die Nachrichten- und Gerätedaten, wie im Abschnitt "Allgemeine Daten" definiert.

  • Absturz-Anhänge Diese Anhänge sind Binärdateien oder Textdateien, die Entwickler optional an einen Absturzbericht anfügen können.

  • Benutzerdefinierte Eigenschaften Diese benutzerdefinierten Schlüsselwertpaare können optional angegeben werden, um ihren Fehlerberichten zusätzlichen Kontext hinzuzufügen.

  • Absturz- und Fehlerbenutzer-ID Dieser eindeutige Bezeichner wird optional vom Entwickler festgelegt, um die Identifikation bestimmter Benutzer an Absturzberichte anzufügen.

  • Symboldateien Diese Symboldateien werden vom Entwickler für App Center bereitgestellt, um Abstürze zu symbolisch zu machen.

Verteilen

  • Token Diese GUID wird an den Verteilungsdienst gesendet, um nach einer neuen Version der Anwendung zu suchen. Die GUID wird nur gesendet, wenn die Anwendung mit App Center installiert wurde.