Freigeben über

Abrufen von App-Akquisitionstrichterdaten

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

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 Kauftrichterdaten abrufen möchten. Ein Beispiel für eine Store-ID ist 9WZDNCRFJ3Q8. Ja
Startdatum Datum Das Startdatum im Datumsbereich der Abzurufenden Trichterdaten. Der Standardwert ist das aktuelle Datum. Nein
Enddatum Datum Das Enddatum im Datumsbereich der Abzurufenden Trichterdaten. Der Standardwert ist das aktuelle Datum. Nein
Filter Schnur Eine oder mehrere Aussagen, die die Zeilen in der Antwort filtern. Für weitere Informationen siehe den Abschnitt Filterfelder weiter unten. Nein

 

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.

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

Felder BESCHREIBUNG
Kampagnen-ID Die ID-Zeichenfolge für eine benutzerdefinierte App-Werbekampagne, die der Akquisition zugeordnet ist.
Markt Eine Zeichenfolge, die den ISO 3166-Ländercode des Marktes enthält, auf dem der Kauf erfolgte.
Gerätetyp Eine der folgenden Zeichenfolgen, die den Gerätetyp angibt, auf dem die Erfassung erfolgt ist:
  • PC
  • Telefon
  • Console-Xbox One
  • Console-Xbox Series X
  • Iot
  • Holographisch
  • Unbekannt
Altersgruppe 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 höher
  • Unbekannt
Geschlecht Eine der folgenden Zeichenfolgen, die das Geschlecht des Benutzers angibt, der den Kauf abgeschlossen hat:
  • M
  • F
  • Unbekannt

Beispielanfrage

Im folgenden Beispiel werden mehrere Anforderungen zum Abrufen von Kauftrichterdaten für eine App veranschaulicht. Ersetzen Sie den Wert applicationId mit der Store-ID Ihrer 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

Antwortkörper

Wert Typ BESCHREIBUNG
Wert Array Ein Array von Objekten, die Akquise-Trichterdaten für die App enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie unten im Abschnitt zu den Trichterwerten.
Gesamtzahl INT Die Gesamtanzahl der Objekte im Value Array.

Trichterwerte

Objekte im Value Array enthalten die folgenden Werte.

Wert Typ BESCHREIBUNG
Metriktyp Schnur Eine der folgenden Zeichenfolgen, die den Typ der Trichterdaten angibt, der in diesem Objekt enthalten ist:
  • PageView
  • Erwerb
  • Installieren
  • Verwendung
Benutzeranzahl Schnur Die Anzahl der Benutzer, die den durch den MetricType Wert angegebenen Funnel-Schritt ausgeführt haben.

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

Beispielantwort

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

Beispielanforderung

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>

Beispielantwort

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