Erhalten Sie Insights-Daten für Ihre Desktopanwendung

2025-06-10

Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um Einblicke in Gesundheitsmetriken für eine Desktopanwendung abzurufen, die Sie dem Windows Desktop-Anwendungsprogrammhinzugefügt haben. Diese Daten sind auch im Gesundheitsbericht für Desktopanwendungen im Partner Center verfügbar.

Voraussetzungen

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

Falls noch nicht geschehen, füllen Sie alle Voraussetzungen für die Microsoft Store-Analyse-API aus.
Holen Sie sich ein Azure AD-Zugriffstoken, um es im Header der Anfrage für diese Methode zu verwenden. Nachdem Sie ein Zugriffstoken abgerufen haben, müssen Sie es 60 Minuten verwenden, bevor es abläuft. Nachdem das Token abgelaufen ist, können Sie eine neue abrufen.

Anfrage

Anforderungssyntax

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

Anforderungs-Kopfzeile

Kopfzeile	Typ	BESCHREIBUNG
Autorisierung	Schnur	Erforderlich. Das Azure AD-Zugriffstoken in der Form Bearer<token>.

Anforderungsparameter

Parameter	Typ	BESCHREIBUNG	Erforderlich
Anwendungs-ID	Schnur	Die Produkt-ID der Desktopanwendung, für die Sie Insights-Daten abrufen möchten. Um die Produkt-ID einer Desktopanwendung abzurufen, öffnen Sie einen beliebigen Analysebericht für Ihre Desktopanwendung im Partner Center (z. B. den Gesundheitsbericht) 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.	Nein
Startdatum	Datum	Das Startdatum im Datumsbereich der abzurufenden Insights-Daten. Der Standardwert ist 30 Tage vor dem aktuellen Datum.	Nein
Enddatum	Datum	Das Enddatum im Datumsbereich der abzurufenden Insights-Daten. Der Standardwert ist das aktuelle Datum.	Nein
Filter	Schnur	Eine oder mehrere Aussagen, die die Zeilen in der Antwort filtern. Jede Anweisung enthält einen Feldnamen aus dem Antworttext und Wert, die dem Eq - oder ne-Operator zugeordnet sind, und Anweisungen können mit undoder oder kombiniert werden. Zeichenfolgenwerte müssen von einfachen Anführungszeichen im Filterparameter umgeben sein. Beispiel: filter=dataType eq 'acquisition'. Derzeit unterstützt diese Methode nur den Filter Gesundheit.	Nein

Beispielanfrage

Im folgenden Beispiel wird eine Anforderung zum Abrufen von Insights-Daten veranschaulicht. Ersetzen Sie den wert applicationId 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

Antwortkörper

Wert	Typ	BESCHREIBUNG
Wert	Array	Ein Array von Objekten, die Daten mit Einblicken für die App enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie unten im Abschnitt Insight-Werte.
Gesamtzahl	INT	Die Gesamtanzahl der Zeilen des Abfrageergebnisses.

Insight-Werte

Elemente im Value-Array enthalten die folgenden Werte.

Wert	Typ	BESCHREIBUNG
Anwendungs-ID	Schnur	Die Produkt-ID der Desktopanwendung, für die Sie Insights-Daten abgerufen haben.
Einblicksdatum	Schnur	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.
Datentyp	Schnur	Eine Zeichenfolge, die den allgemeinen Analysebereich angibt, über den diese Erkenntnis Informationen liefert. Derzeit unterstützt diese Methode nur Gesundheits-.
Einblickdetails	Array	Ein oder mehrere InsightDetail-Werte, die die Details für die aktuelle Erkenntnis darstellen.

InsightDetail-Werte

Wert	Typ	BESCHREIBUNG
FaktName	Schnur	Eine Zeichenfolge, die die Metrik angibt, die der aktuelle Einblick oder die aktuelle Dimension beschreibt. Derzeit unterstützt diese Methode nur den Wert HitCount.
Subdimensionen	Array	Ein oder mehrere Objekte, die eine einzelne Metrik für die Erkenntnis beschreiben.
Prozentänderung	Schnur	Der Prozentsatz, um den sich die Metrik über Ihre gesamte Kundenbasis hinweg geändert hat.
Name der Dimension	Schnur	Der Name der Metrik, die in der aktuellen Dimension beschrieben wird. Beispiele sind EventType, Market, DeviceTypeund PackageVersion.
DimensionWert	Schnur	Der Wert der Metrik, die in der aktuellen Dimension beschrieben wird. Wenn zum Beispiel DimensionNameEventTypeist, kann der Wert von DimensionValueAbsturz oder Stillstandsein.
FaktischerWert	Schnur	Der absolute Wert der Metrik am Datum, an dem der Einblick erkannt wurde.
Richtung	Schnur	Die Richtung der Änderung (positiv oder negativ).
Datum	Schnur	Das Datum, an dem wir die Änderung in Bezug auf die aktuelle Erkenntnis oder die aktuelle Dimension identifiziert haben.

Antwortbeispiel

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
}