Add-Ons erwerben

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 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

Anforderungs-Kopfzeile

Anforderungsparameter

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

Filterfelder

Der Filter Parameter der Anforderung enthält eine oder mehrere Anweisungen, mit denen die Zeilen in der Antwort gefiltert werden. Jede Aussage enthält ein Feld und einen Wert, die den Operatoren eq oder ne zugeordnet sind, und Aussagen können mithilfe von und oder oderkombiniert werden. Dies sind einige Beispiele für Filterparameter:

• filter=market eq 'US' und gender eq 'm'
• filter=(market ne 'US') and (gender ne 'Unbekannt') and (gender ne 'm') and (market ne 'NO') and (ageGroup ne 'größer als 55' or ageGroup ne 'weniger als 13')

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

Beispielanfrage

In den folgenden Beispielen werden verschiedene Anfragen zum Abruf von Daten über den Erwerb von Add-Ons veranschaulicht. Ersetzen Sie die Werte von 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

Antwortkörper

Erweiterungskaufwerte

Elemente im Value-Array enthalten die folgenden Werte.

Beispiel für Anforderung und Antwort

Der folgende Codeausschnitt zeigt eine Beispielanforderung und den JSON-Antwortinhalt für diese Anforderung.

Beispielanforderung

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

Beispielantwort

{
    "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
• Gewinn von Zusatz-Konvertierungen je Kanal
• Abrufen von App-Käufen
• Abrufen von App-Akquisitionstrichterdaten
• Erhalte App-Konvertierungen nach Kanal