Abrufen von Insights-DatenGet insights data

Verwenden Sie diese Methode in der Microsoft Store-Textanalyse-API zum Abrufen von Insights-Daten bei einem bestimmten Zeitraum und andere optionale Filter Übernahmen, Integrität und nutzungsmetriken für eine app im Zusammenhang.Use this method in the Microsoft Store analytics API to get insights data related to acquisitions, health, and usage metrics for an app during a given date range and other optional filters. Diese Informationen sind auch verfügbar in der Insights-Bericht im Partner Center.This information is also available in the Insights report in Partner Center.

VoraussetzungenPrerequisites

Zur Verwendung dieser Methode sind folgende Schritte erforderlich:To use this method, you need to first do the following:

  • Falls noch nicht geschehen, erfüllen Sie alle Voraussetzungen für die Microsoft Store-Analyse-API.If you have not done so already, complete all the prerequisites for the Microsoft Store analytics API.
  • Rufen Sie ein Azure AD-Zugriffstoken ab, das im Anforderungsheader für diese Methode verwendet wird.Obtain an Azure AD access token to use in the request header for this method. Nach Erhalt eines Zugriffstokens können Sie es 60 Minuten lang verwenden, bevor es abläuft.After you obtain an access token, you have 60 minutes to use it before it expires. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.After the token expires, you can obtain a new one.

AnfordernRequest

AnforderungssyntaxRequest syntax

MethodeMethod Anforderungs-URIRequest URI
GETGET https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights

AnforderungsheaderRequest header

HeaderHeader TypType BeschreibungDescription
AutorisierungAuthorization stringstring Erforderlich.Required. Die Azure AD-Zugriffstoken in der Form Bearer < token>.The Azure AD access token in the form Bearer <token>.

AnforderungsparameterRequest parameters

ParameterParameter TypType BeschreibungDescription ErforderlichRequired
applicationIdapplicationId stringstring Die Store ID der app für das Insights-Daten abgerufen werden sollen.The Store ID of the app for which you want to retrieve insights data. Wenn Sie diesen Parameter nicht angeben, enthält der Antworttext die Insights-Daten für alle apps, die mit Ihrem Konto registriert.If you do not specify this parameter, the response body will contain insights data for all apps registered to your account. NeinNo
startDatestartDate datedate Das Startdatum in den Datumsbereich für Insights-Daten abgerufen werden soll.The start date in the date range of insights data to retrieve. Der Standardwert ist 30 Tage vor dem aktuellen Datum.The default is 30 days before the current date. NeinNo
endDateendDate datedate Das Enddatum in den Datumsbereich für Insights-Daten abgerufen werden soll.The end date in the date range of insights data to retrieve. Der Standardwert ist das aktuelle Datum.The default is the current date. NeinNo
filterfilter stringstring Mindestens eine Anweisung, die die Zeilen in der Antwort filtert.One or more statements that filter the rows in the response. Jede Anweisung enthält einen Feldnamen aus dem Antworttext und einen Wert, die mit den Operatoren eq oder ne verknüpft sind. Anweisungen können mit and oder or kombiniert werden.Each statement contains a field name from the response body and value that are associated with the eq or ne operators, and statements can be combined using and or or. Zeichenfolgenwerte im Parameter filter müssen von einfachen Anführungszeichen eingeschlossen werden.String values must be surrounded by single quotes in the filter parameter. Z. B. Filter = DataType-Eq "Übernahme".For example, filter=dataType eq 'acquisition'.

Sie können die folgenden Filterfelder angeben:You can specify the following filter fields:

  • Erwerbacquisition
  • Integritäthealth
  • Verwendungusage
NeinNo

AnforderungsbeispielRequest example

Das folgende Beispiel zeigt eine Anforderung zum Abrufen von Insights-Daten.The following example demonstrates a request for getting insights data. Ersetzen Sie den applicationId-Wert durch die Store-ID Ihrer App.Replace the applicationId value with the Store ID for your app.

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

AntwortResponse

AntworttextResponse body

WertValue TypType BeschreibungDescription
WertValue arrayarray Ein Array von Objekten, die für die app Insights-Daten enthalten.An array of objects that contain insights data for the app. Weitere Informationen zu den Daten in jedem Objekt finden Sie unter der Insight Werte Abschnitt weiter unten.For more information about the data in each object, see the Insight values section below.
TotalCountTotalCount intint Die Gesamtzahl der Zeilen im Datenergebnis für die Abfrage.The total number of rows in the data result for the query.

Insight-WerteInsight values

Elemente im Array Value enthalten die folgenden Werte.Elements in the Value array contain the following values.

WertValue TypType BeschreibungDescription
applicationIdapplicationId stringstring Die Store-ID der app für die Sie Insights-Daten abgerufen werden.The Store ID of the app for which you are retrieving insights data.
insightDateinsightDate stringstring Das Datum, an dem die Änderung in einer bestimmten Metrik erkannt wurden.The date on which we identified the change in a specific metric. Dieses Datum stellt das Ende der Woche, die in der wir eine erhebliche Leistungssteigerung erkannt oder verringern Sie in einer Metrik im Vergleich zu einer Woche davor.This date represents the end of the week in which we detected a significant increase or decrease in a metric compared to the week before that.
DatentypdataType stringstring Eine der folgenden Zeichenfolgen, die den Bereich Allgemeine Analytics gibt an, dem diese Information beschreibt:One of the following strings that specifies the general analytics area that this insight describes:

  • Erwerbacquisition
  • Integritäthealth
  • Verwendungusage
insightDetailinsightDetail arrayarray Eine oder mehrere InsightDetail Werte , die die Details für den aktuellen Insight darstellen.One or more InsightDetail values that represent the details for current insight.

InsightDetail WerteInsightDetail values

WertValue TypType BeschreibungDescription
FactNameFactName stringstring Die folgenden Werte, die die Metrik gibt an, die den aktuellen Insight oder die aktuelle Dimension beschreibt, auf der Grundlage der DataType Wert.One of the following values that indicates the metric that the current insight or current dimension describes, based on the dataType value.
  • Für Integrität, dieser Wert ist immer Trefferanzahl.For health, this value is always HitCount.
  • Für Übernahme, dieser Wert ist immer AcquisitionQuantity.For acquisition, this value is always AcquisitionQuantity.
  • Für Nutzung, dieser Wert kann eine der folgenden Zeichenfolgen:For usage, this value can be one of the following strings:
    • DailyActiveUsersDailyActiveUsers
    • EngagementDurationMinutesEngagementDurationMinutes
    • DailyActiveDevicesDailyActiveDevices
    • DailyNewUsersDailyNewUsers
    • DailySessionCountDailySessionCount
SubDimensionsSubDimensions arrayarray Ein oder mehrere Objekte, die eine einzelne Metrik für die Einblicke zu beschreiben.One or more objects that describe a single metric for the insight.
ProzentPercentChange stringstring Der Prozentsatz, den die Metrik für Ihre gesamte Kundenbasis geändert.The percentage that the metric changed across your entire customer base.
DimensionNameDimensionName stringstring Der Name der Metrik in der aktuellen Dimension beschrieben.The name of the metric described in the current dimension. Beispiele hierfür sind EventType, Markt, "DeviceType", PackageVersion, AcquisitionType, Altersgruppe und Geschlecht.Examples include EventType, Market, DeviceType, PackageVersion, AcquisitionType, AgeGroup and Gender.
DimensionValueDimensionValue stringstring Der Wert der Metrik, die in der aktuellen Dimension beschrieben wird.The value of the metric that is described in the current dimension. Z. B. wenn DimensionName ist EventType, DimensionValue möglicherweise Absturz oder hängen .For example, if DimensionName is EventType, DimensionValue might be crash or hang.
FactValueFactValue stringstring Der Absolute Wert der Metrik auf das Datum, an das der Einblick erkannt wurde.The absolute value of the metric on the date the insight was detected.
DirectionDirection stringstring Die Richtung der Änderung (Positive oder Negative).The direction of the change (Positive or Negative).
DatumDate stringstring Das Datum, an dem die Änderung im Zusammenhang mit der aktuellen Einblick oder die aktuelle Dimension erkannt wurden.The date on which we identified the change related to the current insight or the current dimension.

AntwortbeispielResponse example

Das folgende Beispiel zeigt ein Beispiel für einen JSON-Antworttext für diese Anforderung.The following example demonstrates an example JSON response body for this request.

{
  "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
}