Abrufen von internen Daten für die Desktopanwendung

  • Artikel

Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um Einblicke in Bezug auf Integritätsmetriken für eine Desktopanwendung abzurufen, die Sie dem Windows-Desktopanwendungsprogramm hinzugefügt haben. Diese Daten sind auch im Bericht "Integrität" für Desktopanwendungen im Partner Center verfügbar.

Voraussetzungen

Um diese Methode zu verwenden, müssen Sie zuerst Folgendes tun:

  • Falls noch nicht geschehen, erfüllen Sie alle Voraussetzungen für die Microsoft Store-Analyse-API.
  • Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird. Nachdem Sie ein Zugriffstoken erhalten haben, haben Sie 60 Minuten Zeit, es zu verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.

Anfordern

Anforderungssyntax

Methode Anforderungs-URI
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/insights

Anforderungsheader

Header Typ Beschreibung
Autorisierung Zeichenfolge Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>.

Anforderungsparameter

Parameter Typ Beschreibung Erforderlich
applicationId Zeichenfolge Die Produkt-ID der Desktopanwendung, für die Sie Insights-Daten abrufen möchten. Um die Produkt-ID einer Desktopanwendung abzurufen, öffnen Sie jeden Analysebericht für Ihre Desktopanwendung im Partner Center (z. B. den Integritätsbericht), und rufen Sie die Produkt-ID aus der URL ab. Wenn Sie diesen Parameter nicht angeben, enthält der Antworttext Einblickedaten für alle Apps, die für Ihr Konto registriert sind. No
startDate date Das Startdatum im Datumsbereich der abzurufenden Insights-Daten. Der Standardwert ist 30 Tage vor dem aktuellen Datum. No
endDate date Das Enddatum im Datumsbereich der abzurufenden Insights-Daten. Die Standardeinstellung ist das aktuelle Datum. No
filter Zeichenfolge Eine oder mehrere Anweisungen, die die Zeilen in der Antwort filtern. Jede Anweisung enthält einen Feldnamen aus dem Antwortkörper und einen Wert, die mit den Operatoren eq oder ne verbunden sind, und Anweisungen können mit and oder or kombiniert werden. Zeichenfolgenwerte müssen von einfachen Anführungszeichen im Filter-Parameter umgeben sein. Beispiel: filter=dataType eq 'acquisition'.

Derzeit unterstützt diese Methode nur den Filterstatus.

 No

Anforderungsbeispiel

Im folgenden Beispiel wird eine Anforderung zum Abrufen von Insights-Daten veranschaulicht. Ersetzen Sie den applicationId-Wert durch den entsprechenden Wert für Ihre Desktopanwendung.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/insights?applicationId=10238467886765136388&startDate=6/1/2018&endDate=6/15/2018&filter=dataType eq 'health' HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Antworttext

Wert Typ BESCHREIBUNG
Wert array Ein Array von Objekten, die Einblickedaten für die App enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie im Abschnitt "Insight-Werte " weiter unten.
TotalCount int Die Gesamtanzahl der Zeilen im Datenergebnis für die Abfrage.

Insight-Werte

Elemente im Value-Array enthalten die folgenden Werte.

Wert Typ Beschreibung
applicationId Zeichenfolge Die Produkt-ID der Desktopanwendung, für die Sie Insights-Daten abgerufen haben.
insightDate Zeichenfolge Das Datum, an dem wir die Änderung in einer bestimmten Metrik identifiziert haben. Dieses Datum stellt das Ende der Woche dar, in dem wir im Vergleich zur Vorwoche eine signifikante Zunahme oder Abnahme in einer Metrik festgestellt haben.
dataType Zeichenfolge Eine Zeichenfolge, die den allgemeinen Analysebereich angibt, den dieser Einblick informiert. Derzeit unterstützt diese Methode nur den Zustand.
insightDetail array Mindestens ein InsightDetail-Wert, der die Details für aktuelle Einblicke darstellt.

InsightDetail-Werte

Wert Typ Beschreibung
FactName Zeichenfolge Eine Zeichenfolge, die die Metrik angibt, die der aktuelle Einblick oder die aktuelle Dimension beschreibt. Derzeit unterstützt diese Methode nur den Wert HitCount.
SubDimensions array Mindestens ein Objekt, das eine einzelne Metrik für den Einblick beschreibt.
PercentChange Zeichenfolge Der Prozentsatz, den die Metrik in Ihrer gesamten Kundenbasis geändert hat.
DimensionName Zeichenfolge Der Name der Metrik, die in der aktuellen Dimension beschrieben wird. Beispiele sind EventType, Market, DeviceType und PackageVersion.
DimensionValue Zeichenfolge Der Wert der Metrik, die in der aktuellen Dimension beschrieben wird. Wenn "DimensionName" beispielsweise "EventType" lautet, kann DimensionValue abstürzen oder hängen.
FactValue Zeichenfolge Der absolute Wert der Metrik am Datum, an dem der Einblick erkannt wurde.
Direction Zeichenfolge Die Richtung der Änderung (Positiv oder Negativ).
Datum Zeichenfolge Das Datum, an dem wir die Änderung im Zusammenhang mit dem aktuellen Einblick oder der aktuellen Dimension identifiziert haben.

Beispielantwort

Im folgenden Beispiel wird ein Beispiel für einen JSON-Antworttext für diese Anforderung veranschaulicht.

{
  "Value": [
    {
      "applicationId": "9NBLGGGZ5QDR",
      "insightDate": "2018-06-03T00:00:00",
      "dataType": "health",
      "insightDetail": [
        {
          "FactName": "HitCount",
          "SubDimensions": [
            {
              "FactName:": "HitCount",
              "PercentChange": "21",
              "DimensionValue:": "DE",
              "FactValue": "109",
              "Direction": "Positive",
              "Date": "6/3/2018 12:00:00 AM",
              "DimensionName": "Market"
            }
          ],
          "DimensionValue": "crash",
          "Date": "6/3/2018 12:00:00 AM",
          "DimensionName": "EventType"
        },
        {
          "FactName": "HitCount",
          "SubDimensions": [
            {
              "FactName:": "HitCount",
              "PercentChange": "71",
              "DimensionValue:": "JP",
              "FactValue": "112",
              "Direction": "Positive",
              "Date": "6/3/2018 12:00:00 AM",
              "DimensionName": "Market"
            }
          ],
          "DimensionValue": "hang",
          "Date": "6/3/2018 12:00:00 AM",
          "DimensionName": "EventType"
        },
      ],
      "insightId": "9CY0F3VBT1AS942AFQaeyO0k2zUKfyOhrOHc0036Iwc="
    }
  ],
  "@nextLink": null,
  "TotalCount": 2
}