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 Datumsbereichs und anderer optionaler Filter zu erhalten. Diese Informationen sind auch im Insights-Bericht in Partner Center verfügbar.
Voraussetzungen
Zur Verwendung dieser Methode sind folgende Schritte erforderlich:
- Wenn Sie dies noch nicht getan haben, müssen Sie alle Voraussetzungen für die Microsoft Store-Analyse-API erfüllen.
- 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. Wenn das Token abgelaufen ist, können Sie ein neues abrufen.
Anforderung
Anforderungssyntax
| Methode | Anforderungs-URI |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights |
Anforderungsheader
| Header | type | BESCHREIBUNG |
|---|---|---|
| Authorization | Zeichenfolge | Erforderlich. Das Azure AD-Zugriffstoken im Format Bearertoken<>. |
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 Insights-Daten für alle Apps, die in Ihrem Konto registriert sind. | Nein |
| startDate | date | Das Startdatum im Datumsbereich der abzurufenden Insights-Daten. Der Standardwert ist 30 Tage vor dem aktuellen Datum. | Nein |
| endDate | date | Das Enddatum im Datumsbereich der abzurufenden Insights-Daten. Als Standardeinstellung wird das aktuelle Datum festgelegt. | Nein |
| filter | Zeichenfolge | Mindestens eine Anweisung, die die Zeilen in der Antwort filtert. Jede Anweisung enthält einen Feldnamen aus dem Antworttext und -wert, die den Operatoren eq oder ne zugeordnet sind, und Anweisungen können mit undoder kombiniert werden. Zeichenfolgenwerte im Parameter filter müssen von einfachen Anführungszeichen eingeschlossen werden. 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 Ihrer 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 Insights-Daten für die App enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie weiter unten im Abschnitt Insight-Werte . |
| TotalCount | INT | Die Gesamtzahl der Zeilen im Datenergebnis für die Abfrage. |
Insight-Werte
Elemente im Array Value 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 der wir eine signifikante Zunahme oder Abnahme einer Metrik im Vergleich zur Woche davor festgestellt haben. |
| dataType | Zeichenfolge | Eine der folgenden Zeichenfolgen, die den allgemeinen Analysebereich angibt, den diese Erkenntnis beschreibt:
|
| insightDetail | array | Mindestens ein InsightDetail-Wert , der die Details für den aktuellen Einblick darstellt. |
InsightDetail-Werte
| Wert | Typ | BESCHREIBUNG |
|---|---|---|
| FactName | Zeichenfolge | Einer der folgenden Werte, der die Metrik angibt, die der aktuelle Einblick oder die aktuelle Dimension basierend auf dem dataType-Wert beschreibt.
|
| SubDimensions | array | Mindestens ein Objekt, das eine einzelne Metrik für den Einblick beschreibt. |
| PercentChange | Zeichenfolge | Der Prozentsatz, den die Metrik in Ihrem gesamten Kundenstamm 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 ist, kann DimensionValueabstü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). |
| Date | 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 Akquisitions-, Integritäts- und/oder Nutzungsdaten.
Anforderungs- und Antwortbeispiel
Die folgenden Codeausschnitte zeigen einige Beispielanforderungen und JSON-Antworttexte für diese Anforderung.
Beispiel für eine Anforderung
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
}
Zugehörige Themen
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für