Abrufen von Add-On-Käufen

Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um aggregierte Kaufdaten für Add-Ons für Ihre App im JSON-Format während eines bestimmten Zeitraums und anderer optionaler Filter abzurufen. Diese Informationen sind auch im Bericht "Add-On-Käufe" 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

Anforderungsheader

Anforderungsparameter

Der Parameter applicationId oder inAppProductId ist erforderlich. Um Kaufdaten für alle add-ons abzurufen, die für die App registriert sind, geben Sie den applicationId-Parameter an. Um Kaufdaten für ein einzelnes Add-On abzurufen, geben Sie den Parameter inAppProductId an. Wenn Sie beide angeben, wird der applicationId-Parameter ignoriert.

Filter (Felder)

Der Filter-Parameter der Anforderung enthält eine oder mehrere Anweisungen, die die Zeilen in der Antwort filtern. Jede Anweisung enthält ein Feld und einen Wert, die den Operatoren eq oder ne zugeordnet sind, und Anweisungen können mithilfe und oder oder kombiniert werden. Hier sind einige Beispiel-Filter-Parameter:

• filter=market eq 'US' und gender eq 'm'
• filter=(market ne 'US') and (gender ne 'Unknown') and (gender ne 'm') and (market ne 'NO') and (ageGroup ne 'greater than 55' or ageGroup ne 'less than 13')

Eine Liste der unterstützten Felder finden Sie in der folgenden Tabelle. Zeichenfolgenwerte müssen von einfachen Anführungszeichen im Filter-Parameter umgeben sein.

Anforderungsbeispiel

In den folgenden Beispielen werden verschiedene Anforderungen zum Abrufen von Add-On-Kaufdaten veranschaulicht. Ersetzen Sie die Werte inAppProductId und applicationId durch die entsprechende Store-ID für Ihr Add-On oder Ihre App.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappacquisitions?inAppProductId=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/inappacquisitions?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/inappacquisitions?inAppProductId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=7/3/2015&top=100&skip=0&filter=market ne 'US' and gender ne 'Unknown' and gender ne 'm' and market ne 'NO' and ageGroup ne '>55' HTTP/1.1
Authorization: Bearer <your access token>

Antwort

Antworttext

Add-On-Akquisitionswerte‭

Elemente im Value-Array enthalten die folgenden Werte.

Beispiel für Anforderung und Antwort

Der folgende Codeausschnitt veranschaulicht einen Beispieltext für Anforderungs- und JSON-Antwort für diese Anforderung.

Beispiel-Anfrage

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

Beispiel für eine Antwort

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Deluxe Collector's Edition",
            "addonProductId": "9NBLGGAAGZDQ",
            "date": "2022-07-29",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 18.12,
            "purchasePriceLocalAmount": 18.12,
            "purchaseTaxUSDAmount": 1.13,
            "purchaseTaxLocalAmount": 1.13
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Episode 4",
            "addonProductId": "9NAAAAAAAAAQ",
            "date": "2017-01-07",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 4.147206,
            "purchasePriceLocalAmount": 3.99,
            "purchaseTaxUSDAmount": 0.686004,
            "purchaseTaxLocalAmount": 0.66
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Deluxe Collector's Edition",
            "addonProductId": "9NALGGGZ5QDQ",
            "date": "2018-04-01",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 1.99,
            "purchasePriceLocalAmount": 1.99,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Strategy Guide Episode 4",
            "addonProductId": "9NBLGGGZ5QDQ",
            "date": "2021-11-25",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 1.31902922876179,
            "purchasePriceLocalAmount": 150.0,
            "purchaseTaxUSDAmount": 0.114315866492689,
            "purchaseTaxLocalAmount": 13.0
        },
    ],
    "TotalCount": 4,
    "DataFreshnessTimestamp": "2022-07-29T05:54:00"
}

Zugehörige Themen

• Bericht zu Add-On-Käufen
• Zugreifen auf Analysedaten mithilfe von Microsoft Store-Diensten
• Abrufen von Add-On-Konvertierungen nach Kanal
• Abrufen von App-Käufen
• Abrufen von App-Erwerbstrichterdaten
• Abrufen von App-Konvertierungen nach Kanal