Freigeben über

Abrufen von App-Erwerbstrichterdaten

  • Artikel

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

Methode Anforderungs-URI
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel

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 Kauftrichterdaten abrufen möchten. Ein Beispiel für die Store-ID ist 9WZDNCRFJ3Q8. Ja
startDate date Das Startdatum im Datumsbereich der Abzurufenden Trichterdaten. Die Standardeinstellung ist das aktuelle Datum. No
endDate date Das Enddatum im Datumsbereich der Abzurufenden Trichterdaten. Die Standardeinstellung ist das aktuelle Datum. No
filter Zeichenfolge Eine oder mehrere Anweisungen, die die Zeilen in der Antwort filtern. Weitere Informationen finden Sie im Abschnitt zu Filterfelder weiter unten. No

 

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.

Die folgenden Filterfelder werden unterstützt. Zeichenfolgenwerte müssen von einfachen Anführungszeichen im Filter-Parameter umgeben sein.

Felder Beschreibung
campaignId Die ID-Zeichenfolge für eine benutzerdefinierte App-Werbekampagne , die dem Erwerb zugeordnet ist.
Markt Eine Zeichenfolge, die den ISO 3166-Ländercode des Marktes enthält, auf dem der Kauf erfolgte.
deviceType Eine der folgenden Zeichenfolgen, die den Gerätetyp angibt, auf dem der Kauf aufgetreten ist:
  • PC
  • Telefonnummer
  • Konsolen-Xbox One
  • Konsolen-Xbox Series X
  • IoT
  • Holographisch
  • Unbekannt
ageGroup Eine der folgenden Zeichenfolgen, die die Altersgruppe des Benutzers angibt, der den Erwerb abgeschlossen hat:
  • 0 – 17
  • 18 – 24
  • 25 – 34
  • 35 – 49
  • 50 oder mehr
  • Unbekannt
gender Eine der folgenden Zeichenfolgen, die das Geschlecht des Benutzers angibt, der den Kauf abgeschlossen hat:
  • M
  • F
  • Unbekannt

Anforderungsbeispiel

Im folgenden Beispiel werden mehrere Anforderungen zum Abrufen von Kauftrichterdaten für eine App veranschaulicht. Ersetzen Sie den applicationId-Wert durch die Store-ID für Ihre App.

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

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

Antwort

Antworttext

Wert Typ BESCHREIBUNG
Wert array Ein Array von Objekten, die Kauftrichterdaten für die App enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie unten im Abschnitt "Trichterwerte ".
TotalCount int Die Gesamtanzahl der Objekte im Value-Array .

Trichterwerte

Jedes Objekt in der Matrix Wert enthält die folgenden Werte:

Wert Typ Beschreibung
MetricType Zeichenfolge Eine der folgenden Zeichenfolgen, die den Typ der Trichterdaten angibt, die in diesem Objekt enthalten sind:
  • PageView
  • Erwerb
  • Installieren
  • Verwendung
UserCount Zeichenfolge Die Anzahl der Benutzer, die den durch den MetricType-Wert angegebenen Trichterschritt ausgeführt haben.

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/funnel?applicationId=9NBLGGGZ5QDR
HTTP/1.1
Authorization: Bearer <your access token>

Beispiel für eine Antwort

{
    "Value": [
        {
            "MetricType": "PageView",
            "UserCount": 6214
        },
        {
            "MetricType": "Acquisition",
            "UserCount": 1502
        },
        {
            "MetricType": "Usage",
            "UserCount": 606
        },
        {
            "MetricType": "Install",
            "UserCount": 977
        }
    ],
    "TotalCount": 4
}

Beispiel-Anfrage

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=12/19/2021&endDate=12/21/2021&filter=market eq 'US' and gender eq 'm'
HTTP/1.1
Authorization: Bearer <your access token>

Beispiel für eine Antwort

{
    "Value": [
        {
            "MetricType": "PageView",
            "UserCount": 10
        },
        {
            "MetricType": "Acquisition",
            "UserCount": 8
        },
        {
            "MetricType": "Usage",
            "UserCount": 5
        },
        {
            "MetricType": "Install",
            "UserCount": 3
        }
    ],
    "TotalCount": 4
}