Abrufen der täglichen App-Nutzung
Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um aggregierte Nutzungsdaten (nicht einschließlich Xbox Multiplayer) im JSON-Format für eine Anwendung während eines bestimmten Zeitraums (nur letzte 90 Tage) und andere optionale Filter abzurufen. Diese Informationen sind auch im Nutzungsbericht im Partner Center verfügbar.
Telemetrie für anaheimbasierte PWA-Apps wird auf Geräteebene erfasst. Metriken im Zusammenhang mit Benutzern stehen daher für solche Produkte nicht zur Verfügung. Weitere Informationen zur Gültigkeit von Feldern finden Sie im folgenden Abschnitt "Nutzungswerte".
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/usagedaily |
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 Rezensionsdaten abrufen möchten. | Ja |
| startDate | date | Das Startdatum im Datumsbereich der abzurufenden Überprüfungsdaten. Die Standardeinstellung ist das aktuelle Datum. | No |
| endDate | date | Das Enddatum im Datumsbereich der abzurufenden Überprüfungsdaten. Die Standardeinstellung ist das aktuelle Datum. | Nein |
| Oben | int | Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Der Höchstwert und der Standardwert, falls nicht angegeben, ist 10000. Wenn in der Abfrage weitere Zeilen vorhanden sind, enthält der Antworttext einen nächsten Link, den Sie verwenden können, um die nächste Seite mit Daten anzufordern. | Nein |
| skip | int | Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datasets zu durchlaufen. Beispielsweise ruft top=10000 und skip=0 die ersten 10000 Datenzeilen ab, top=100000 und skip=10000 ruft die nächsten 10000 Datenzeilen usw. ab. | Nein |
| 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 Filterparameter umgeben sein. Sie können die folgenden Felder aus dem Antworttext angeben:
|
No |
| orderby | Zeichenfolge | Eine Anweisung, die die Ergebnisdatenwerte anordnet. Die Syntax ist orderby=Feld [order], Feld [order],.... Der Feld-Parameter kann eine der folgenden Zeichenfolgen sein:
Der Order-Parameter ist optional und kann asc oder desc sein, um die aufsteigende oder absteigende Reihenfolge für jedes Feld anzugeben. Die Standardeinstellung ist asc. Hier ist ein Beispiel für eine orderby-Zeichenfolge: orderby=date,market |
Nein |
| groupby | Zeichenfolge | Eine Anweisung, die Datenaggregation nur auf die angegebenen Felder anwendet. Sie können die folgenden Felder aus dem Antworttext angeben:
Die zurückgegebenen Datenzeilen enthalten die im groupby-Parameter angegebenen Felder sowie Folgendes:
Der groupby-Parameter kann mit dem aggregationLevel-Parameter verwendet werden. Zum Beispiel: &groupby=ageGroup,market&aggregationLevel=week |
No |
Anforderungsbeispiel
Im folgenden Beispiel wird eine Anforderung zum Abrufen von täglichen App-Nutzungsdaten veranschaulicht. Ersetzen Sie den applicationId-Wert durch die Store-ID für Ihre App.
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/usagedaily?applicationId=XXXXXXXXXXXX&startDate=2018-08-10&endDate=2018-08-14 HTTP/1.1
Authorization: Bearer <your access token>
Antwort
Antworttext
| Wert | Typ | BESCHREIBUNG |
|---|---|---|
| Wert | array | Ein Array von Objekten, die aggregierte Nutzungsdaten enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie in der folgenden Tabelle. |
| @nextLink | Zeichenfolge | Wenn zusätzliche Datenseiten vorhanden sind, enthält diese Zeichenfolge einen URI, den Sie verwenden können, um die nächste Seite mit Daten anzufordern. Dieser Wert wird beispielsweise zurückgegeben, wenn der oberste Parameter der Anforderung auf 10000 festgelegt ist, es aber mehr als 10000 Zeilen mit Rezensionsdaten für die Abfrage gibt. |
| TotalCount | int | Die Gesamtanzahl der Zeilen im Datenergebnis für die Abfrage. |
Verwendungswerte
Elemente im Value-Array enthalten die folgenden Werte.
| Wert | Typ | Beschreibung | UWP-Verfügbarkeit | Anaheimbasierte PWA-Verfügbarkeit | Xbox-Verfügbarkeit |
|---|---|---|---|---|---|
| date | Zeichenfolge | Das erste Datum im Datumsbereich für die Nutzungsdaten. Wenn die Anforderung einen einzelnen Tag angegeben hat, ist dieser Wert dieses Datum. Wenn die Anforderung eine Woche, einen Monat oder einen anderen Datumsbereich angegeben hat, ist dieser Wert das erste Datum in diesem Datumsbereich. | Ja | Ja | Ja |
| applicationId | Zeichenfolge | Die Store-ID der App, für die Sie Nutzungsdaten abrufen. | Ja | Ja | Ja |
| applicationName | Zeichenfolge | Der Anzeigename der App. | Ja | Ja | Ja |
| deviceType | Zeichenfolge | Eine der folgenden Zeichenfolgen, die den Typ des Geräts angibt, auf dem die Verwendung erfolgt ist:
|
Ja | Ja | Ja |
| packageVersion | Zeichenfolge | Die Version des Pakets, in dem die Verwendung erfolgt ist. | Ja | Ja | No |
| Markt | Zeichenfolge | Der ISO 3166-Ländercode des Marktes, in dem der Kunde Ihre App verwendet hat. | Ja | Ja | Ja |
| subscriptionName | Zeichenfolge | Gibt an, ob die Verwendung über Xbox Game Pass erfolgt ist. | Ja | Nr. | No |
| dailySessionCount | long | Die Anzahl der Benutzersitzungen an diesem Tag. | Ja | Ja | Ja |
| engagementDurationMinutes | double | Die Minuten, in denen Benutzer Ihre App aktiv verwenden, gemessen nach einem bestimmten Zeitraum, beginnend beim Start der App (Prozessstart) und beim Beenden (Prozessende) oder nach einem Zeitraum der Inaktivität. | Ja | Ja | Ja |
| dailyActiveUsers | long | Die Anzahl der Kunden, die die App an diesem Tag verwenden. | Ja | Keine | Ja |
| dailyActiveDevices | long | Die Anzahl der täglichen Geräte, die für die Interaktion mit Ihrer App von allen Benutzern verwendet werden. | Ja | Ja | Ja |
| dailyNewUsers | long | Die Anzahl der Kunden, die Ihre App zum ersten Mal an diesem Tag verwendet haben. | Ja | Keine | Ja |
| monthlyActiveUsers | long | Die Anzahl der Kunden, die die App in diesem Monat verwenden. | Ja | Keine | Ja |
| monthlyActiveDevices | long | Die Anzahl der Geräte, die Ihre App für einen bestimmten Zeitraum ausführen, beginnend beim Starten der App (Prozessstart) und beenden, wenn sie beendet wird (Prozessende) oder nach einem Zeitraum der Inaktivität. | Ja | Ja | Ja |
| monthlyNewUsers | long | Die Anzahl der Kunden, die Ihre App zum ersten Mal in diesem Monat verwendet haben. | Ja | Keine | Ja |
| dailyNewDevices | long | Die Anzahl der Geräte, die die App zum ersten Mal an diesem Tag verwendet haben. | No | Ja | No |
| monthlyNewDevices | long | Die Anzahl der Geräte, die die App zum ersten Mal in den letzten 30 Tagen verwendet haben. | No | Ja | Nein |
Hinweis
Wenn ein Feld für ein bestimmtes Produkt nicht gültig ist, wird der Wert an diese Felder in der Antwort als 0 oder NULL gesendet. Die Berechnung neuer Benutzer und neuer Geräte erfolgt mit dem rollierenden Fenster von 3 Jahren, d. h., wenn ein Benutzer/Gerät die Anwendung 3 Jahre und höher nicht verwendet, wird sie nach 3 Jahren als neuer Benutzer/Gerät behandelt.
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/usagedaily?applicationId=9NBLGGGZ5QDR
HTTP/1.1
Authorization: Bearer <your access token>
Beispiel für eine Antwort
{
"Value": [
{
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"deviceType": "All",
"packageVersion": "All",
"market": "All",
"dailySessionCount": 6102,
"engagementDurationMinutes": 75801.0,
"dailyActiveUsers": 3866,
"dailyActiveDevices": 3855,
"dailyNewUsers": 2041,
"monthlyActiveUsers": 85206,
"monthlyActiveDevices": 88995,
"monthlyNewUsers": 63184,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
}
],
"TotalCount": 1
}
Beispiel-Anfrage
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/usagedaily?applicationId=9NBLGGGZ5QDR&startDate=06/19/2022&endDate=07/20/2022&top=10&skip=0&groupby=applicationName,subscriptionName,deviceType,packageVersion,market,date
HTTP/1.1
Authorization: Bearer <your access token>
Beispiel für eine Antwort
{
"Value": [
{
"date": "2022-07-11",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "1.4.0.17837",
"market": "BR",
"dailySessionCount": 1,
"engagementDurationMinutes": 35.2,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 1,
"monthlyActiveDevices": 1,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-07-04",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AD",
"dailySessionCount": 1,
"engagementDurationMinutes": 2.7,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 1,
"monthlyActiveDevices": 1,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-24",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AE",
"dailySessionCount": 2,
"engagementDurationMinutes": 2.9,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 2,
"monthlyActiveDevices": 2,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-07-08",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AE",
"dailySessionCount": 1,
"engagementDurationMinutes": 0.5,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 2,
"monthlyActiveDevices": 2,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-26",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AO",
"dailySessionCount": 1,
"engagementDurationMinutes": 1.2,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 1,
"monthlyActiveDevices": 1,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-19",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AR",
"dailySessionCount": 1,
"engagementDurationMinutes": 1.0,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 40,
"monthlyActiveDevices": 40,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-20",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AR",
"dailySessionCount": 2,
"engagementDurationMinutes": 10.9,
"dailyActiveUsers": 2,
"dailyActiveDevices": 2,
"dailyNewUsers": 0,
"monthlyActiveUsers": 42,
"monthlyActiveDevices": 42,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-21",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AR",
"dailySessionCount": 6,
"engagementDurationMinutes": 32.8,
"dailyActiveUsers": 3,
"dailyActiveDevices": 3,
"dailyNewUsers": 0,
"monthlyActiveUsers": 44,
"monthlyActiveDevices": 43,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-22",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AR",
"dailySessionCount": 1,
"engagementDurationMinutes": 0.1,
"dailyActiveUsers": 1,
"dailyActiveDevices": 1,
"dailyNewUsers": 0,
"monthlyActiveUsers": 43,
"monthlyActiveDevices": 42,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
},
{
"date": "2022-06-23",
"applicationId": "9NBLGGGZ5QDR",
"applicationName": "Contoso Demo",
"subscriptionName": "null",
"deviceType": "PC",
"packageVersion": "2.5.2.34894",
"market": "AR",
"dailySessionCount": 2,
"engagementDurationMinutes": 0.3,
"dailyActiveUsers": 2,
"dailyActiveDevices": 2,
"dailyNewUsers": 0,
"monthlyActiveUsers": 42,
"monthlyActiveDevices": 42,
"monthlyNewUsers": 0,
"dailyNewDevices": 0,
"monthlyNewDevices": 0
}
],
"@nextLink": "usagedaily?applicationId=9NBLGGGZ5QDR&startDate=2022/06/19&endDate=2022/07/21&groupby=applicationName,subscriptionName,deviceType,packageVersion,market,date&top=10&skip=10",
"TotalCount": 765
}