Abrufen von Insights-Daten
Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um Erkenntnisse zu Käufen, Integritäts- und Nutzungsmetriken für eine App während eines bestimmten Zeitraums und andere optionale Filter abzurufen. Diese Informationen sind auch im Insights-Bericht 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/insights |
Anforderungsheader
| Header | Typ | Beschreibung |
|---|---|---|
| Autorisierung | Zeichenfolge | Erforderlich. Das Azure AD-Zugriffstoken im Formular Bearer<-Token>. |
Anforderungsparameter
| Parameter | Typ | Beschreibung | Erforderlich |
|---|---|---|---|
| applicationId | Zeichenfolge | Die Store-ID der App, für die Sie Insights-Daten abrufen möchten. 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'. Sie können die folgenden Filterfelder angeben:
|
Ja |
Anforderungsbeispiel
Im folgenden Beispiel wird eine Anforderung zum Abrufen von Insights-Daten veranschaulicht. Ersetzen Sie den applicationId-Wert durch die Store-ID für Ihre 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>
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 Store-ID der App, für die Sie Insights-Daten abrufen. |
| 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 der folgenden Zeichenfolgen, die den allgemeinen Analysebereich angibt, den dieser Einblick beschreibt:
|
| insightDetail | array | Mindestens ein InsightDetail-Wert, der die Details für aktuelle Einblicke darstellt. |
InsightDetail-Werte
| Wert | Typ | Beschreibung |
|---|---|---|
| FactName | Zeichenfolge | Einer der folgenden Werte, der die Metrik angibt, die der aktuelle Einblick oder die aktuelle Dimension beschreibt, basierend auf dem DataType-Wert .
|
| 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, PackageVersion, AcquisitionType, AgeGroup und Gender. |
| 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. |
Hinweis
Die abgerufenen Insights-Änderungen gelten nur für die letzten 30 Tage von Käufen, Integritäts- und/oder Nutzungsdaten.
Beispiel für Anforderung und Antwort
Die folgenden Codeausschnitte zeigen beispielweise Anforderungs- und JSON-Antworttext für diese Anforderung.
Beispiel-Anfrage
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights?applicationId=9NBLGGGZ5QDR&startDate=7/12/2022&endDate=7/29/2022&filter=dataType eq 'acquisition' or dataType eq 'health'
HTTP/1.1
Authorization: Bearer <your access token>
Beispiel für eine Antwort
{
"Value": [
{
"id": "8cdb672c7893bd33a3dec48ededdc676602a1361f3209ab4f3e0982672fc198f",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-27T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-27 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "DeviceType",
"DimensionValue": "Tablet",
"Date": "2022-07-27 00:00:00",
"Direction": "Positive",
"PercentChange": 16.091954022988507,
"FactName": "AcquisitionQuantity",
"FactQuantity": 28.0
}
]
}
]
},
{
"id": "6b8849ecb043c6e5ecdd1c20040c0a371e9ab176eff77f7312b0489e19379225",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-26T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-26 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "DeviceType",
"DimensionValue": "Tablet",
"Date": "2022-07-26 00:00:00",
"Direction": "Positive",
"PercentChange": 28.048780487804876,
"FactName": "AcquisitionQuantity",
"FactQuantity": 30.0
}
]
}
]
},
{
"id": "93115e855fec507385bab17251f49c33bcbc1b62c603e5c7863e327ba94bf160",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-20T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-20 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "GB",
"Date": "2022-07-20 00:00:00",
"Direction": "Negative",
"PercentChange": 3.3035714285714284,
"FactName": "AcquisitionQuantity",
"FactQuantity": 158.0
}
]
}
]
},
{
"id": "4814abe710042a2798b453d8821909c246c389dde814e6678da7189211410604",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-24T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-24 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "DO",
"Date": "2022-07-24 00:00:00",
"Direction": "Negative",
"PercentChange": 13.533834586466165,
"FactName": "AcquisitionQuantity",
"FactQuantity": 8.0
}
]
}
]
},
{
"id": "7941070bb17904f3ef4e19de9659110cb52e18ecfb637ad724e2da749445a860",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-21T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-21 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "AT",
"Date": "2022-07-21 00:00:00",
"Direction": "Positive",
"PercentChange": 0.0,
"FactName": "AcquisitionQuantity",
"FactQuantity": 17.0
}
]
},
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-21 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "SE",
"Date": "2022-07-21 00:00:00",
"Direction": "Negative",
"PercentChange": 21.686746987951807,
"FactName": "AcquisitionQuantity",
"FactQuantity": 5.0
}
]
}
]
},
{
"id": "55905f5458617b65669eb115cc28ebd7296841bd2ff3f8e2546ade1d5e93f68d",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-13T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "AcquisitionType",
"DimensionValue": "Free",
"Date": "2022-07-13 00:00:00",
"FactName": "AcquisitionQuantity",
"SubDimensions": [
{
"DimensionName": "Market",
"DimensionValue": "LK",
"Date": "2022-07-13 00:00:00",
"Direction": "Negative",
"PercentChange": 11.111111111111111,
"FactName": "AcquisitionQuantity",
"FactQuantity": 9.0
}
]
}
]
},
{
"id": "9ce9317bf4d0f903de51a49d00a07cf4b4a8ac4457fd1e2886493bd38ceac0b7",
"applicationId": "9NBLGGGZ5QDR",
"insightDate": "2022-07-19T00:00:00",
"dataType": "acquisition",
"insightDetail": [
{
"DimensionName": "Acquisition",
"DimensionValue": "Free",
"Date": "2022-07-19 00:00:00",
"Direction": "Negative",
"PercentChange": 12.188725230475788,
"FactName": "AcquisitionQuantity",
"FactQuantity": 2470,
"SubDimensions": []
}
]
}
],
"TotalCount": 7
}