Freigeben über

App-Erwerbungen erhalten

Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um aggregierte Kaufdaten im JSON-Format für eine Anwendung während eines bestimmten Zeitraums und andere optionale Filter abzurufen. Diese Informationen sind auch im Akquisitionsbericht 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/appacquisitions

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 Store-ID der App, für die Sie Kaufdaten abrufen möchten. Ja
Startdatum Datum Das Startdatum im angegebenen Datumsbereich der abzurufenden Erfassungsdaten. Der Standardwert ist das aktuelle Datum. Nein
Enddatum Datum Das Enddatum im Datumsbereich der abzurufenden Daten. Der Standardwert ist das aktuelle Datum. Nein
Nach oben INT Die Anzahl der Datenzeilen, die in der Anforderung zurückgegeben werden sollen. Der Maximalwert und der Standardwert, wenn nicht angegeben ist, 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
hüpfen INT Die Anzahl der Zeilen, die in der Abfrage übersprungen werden sollen. Verwenden Sie diesen Parameter, um große Datensätze zu durchblättern. 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 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=market eq 'US' und gender eq 'm'.

Sie können die folgenden Felder aus dem Antworttext angeben:

  • Erwerbsart
  • Altersgruppe-
  • Kunde speichern
  • Geschlecht
  • Markt
  • Betriebssystemversion
  • Gerätetyp
  • Name der Bestellung
 Nein
Aggregationsniveau Schnur Gibt den Zeitraum an, für den aggregierte Daten abgerufen werden sollen. Dies kann eine der folgenden Zeichenfolgen sein: Tag, Wocheoder Monat. Wenn nicht angegeben, liegt der Standardwert bei Tag. Nein
Sortierung nach Schnur Eine Anweisung, die die Ergebnisdatenwerte für jede Erfassung anordnet. Die Syntax lautet orderby=field [order],field [order],.... Der field-Parameter kann eine der folgenden Zeichenfolgen sein:
  • Datum
  • Erwerbsart
  • Altersgruppe-
  • Kunde speichern
  • Geschlecht
  • Markt
  • Betriebssystemversion
  • Gerätetyp
  • Name der Bestellung

Der Order-Parameter ist optional und kann asc oder desc sein, um die aufsteigende oder absteigende Reihenfolge für jedes Feld anzugeben. Der Standardwert ist asc.

Hier ist ein Beispiel für eine Orderby-Zeichenfolge : orderby=date,market

 Nein
GruppierenNach Schnur Eine Aussage, die die Datenaggregation nur auf die angegebenen Felder anwendet. Sie können die folgenden Felder angeben:
  • Datum
  • Name der Anwendung
  • Erwerbsart
  • Altersgruppe-
  • Kunde speichern
  • Geschlecht
  • Markt
  • Betriebssystemversion
  • Gerätetyp
  • Name der Bestellung

Die zurückgegebenen Datenzeilen enthalten die im groupby Parameter angegebenen Felder sowie folgendes:

  • Datum
  • Anwendungs-ID
  • Anschaffungsmenge

Der Parameter groupby kann mit dem Parameter aggregationLevel verwendet werden. Beispiel: &groupby=ageGroup,market&aggregationLevel=week

 Nein

Beispielanfrage

Im folgenden Beispiel werden mehrere Anforderungen zum Abrufen von App-Kaufdaten veranschaulicht. Ersetzen Sie den Wert applicationId mit der Store-ID Ihrer App.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?applicationId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0  HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?applicationId=9NBLGGGZ5QDR&startDate=8/1/2015&endDate=8/31/2015&skip=0&filter=market eq 'US' and gender eq 'm'  HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Antwortkörper

Wert Typ BESCHREIBUNG
Wert Array Ein Array von Objekten, das zusammengefasste Kaufdaten für die App enthält. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie in den Kaufwerten Abschnitt unten.
@nextLink Schnur 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 z. B. zurückgegeben, wenn der top Parameter der Anforderung auf 10000 festgelegt ist, es jedoch mehr als 10000 Zeilen mit Erhebungsdaten für die Abfrage gibt.
Gesamtzahl INT Die Gesamtanzahl der Zeilen des Abfrageergebnisses.

Anschaffungswerte

Elemente im Value-Array enthalten die folgenden Werte.

Wert Typ BESCHREIBUNG
Datum Schnur Das erste Datum im Datumsbereich für die Erfassungsdaten. 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.
Anwendungs-ID Schnur Die Store-ID der App, für die Sie Kaufdaten abrufen.
Anwendungsname Schnur Der Anzeigename der App.
Gerätetyp Schnur Eine der folgenden Zeichenfolgen, die den Typ des Geräts angibt, auf dem die Erfassung erfolgt ist:
  • PC
  • Telefon
  • Console-Xbox Eins
  • Console-Xbox Serie X
  • Iot
  • Holographisch
  • Unbekannt
Bestellname Schnur Der Name der Bestellung.
storeClient Schnur Eine der folgenden Zeichenfolgen, die die Version des Stores angibt, in der der Kauf erfolgte:
  • 'Windows Phone Store' (Kunde)
  • Microsoft Store (Client) (oder Windows Store (Client), wenn Daten vor dem 23. März 2018 abfragen)
  • Microsoft Store (Web) (oder Windows Store (Web), wenn Daten vor dem 23. März 2018 abfragen)
  • Mengenabnahme durch Unternehmen
  • Andere
osVersion Schnur Eine der folgenden Zeichenfolgen, die die Betriebssystemversion angibt, bei der die Erfassung stattgefunden hat:
  • Windows Phone 7.5
  • Windows Phone 8
  • Windows Phone 8.1
  • Windows Phone 10
  • Windows 8
  • Windows 8.1
  • Windows 10
  • Windows 11
  • Unbekannt
Markt Schnur Der ISO 3166-Ländercode des Marktes, auf dem der Erwerb erfolgte.
Geschlecht Schnur Eine der folgenden Zeichenfolgen, die das Geschlecht des Benutzers angibt, der den Kauf getätigt hat:
  • m
  • f
  • Unbekannt
Altersgruppe Schnur Eine der folgenden Zeichenfolgen, die die Altersgruppe des Benutzers angibt, der den Kauf getätigt hat:
  • weniger als 13
  • 13-17
  • 18-24
  • 25-34
  • 35-44
  • 44-55
  • größer als 55
  • Unbekannt
Erwerbstyp Schnur Eine der folgenden Strings, die den Typ der Akquisition angibt:
  • Kostenlos
  • Testversion
  • Kostenpflichtige
  • Gutscheincode
  • Iap
  • Abonnement-In-App-Käufe
  • private Zielgruppe
  • Vorbestellung
  • Xbox Game Pass (oder Game Pass, wenn Sie Daten abfragen, die vor dem 23. März 2018 liegen)
  • Datenträger
  • Prepaid-Code
Erwerbsmenge Zahl Die Anzahl der Käufe, die während der angegebenen Aggregationsebene aufgetreten sind.

Beispiel für Anforderung und Antwort

Die folgenden Codeausschnitte zeigen einige Beispielanforderungen und den JSON-Antwortkörper für diese Anforderungen.

Beispielanforderung

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?applicationId=9NBLGGGZ5QDR  HTTP/1.1
Authorization: Bearer <your access token>

Beispielantwort

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "date": "2022-07-29",
            "acquisitionQuantity": 7,
            "purchasePriceUSDAmount": 0.0,
            "purchasePriceLocalAmount": 0.0,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
  ],
  "TotalCount": 1,
  "DataFreshnessTimestamp": "2022-07-29T08:42:00"
}

Beispielanforderung

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appacquisitions?applicationId=9NBLGGGZ5QDR&startDate=8/1/2021&endDate=12/21/2021&skip=0&filter=market&groupby=date,applicationName,acquisitionType,ageGroup,storeClient,gender,market,osVersion,deviceType  HTTP/1.1
Authorization: Bearer <your access token>

Beispielantwort

	{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "acquisitionType": "Free",
            "storeClient": "Microsoft Store (client)",
            "gender": "f",
            "market": "TW",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "date": "2021-08-01",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 0.0,
            "purchasePriceLocalAmount": 0.0,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "acquisitionType": "Free",
            "storeClient": "Microsoft Store (client)",
            "gender": "Unknown",
            "market": "BR",
            "osVersion": "Windows 10",
            "deviceType": "PC",
            "date": "2021-08-01",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 0.0,
            "purchasePriceLocalAmount": 0.0,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
      ],  
  "TotalCount": 2,
  "DataFreshnessTimestamp": "2022-07-29T08:42:00"
 }