Freigeben über

Erzielen von Zusatzkonvertierungen nach Kanal

Verwenden Sie diese Methode in der Microsoft Store-Analyse-API, um aggregierte Konvertierungen nach Kanal für ein Add-On während eines bestimmten Zeitraums und andere optionale Filter abzurufen.

  • Eine Konvertierung bedeutet, dass ein Kunde (mit einem Microsoft-Konto angemeldet) eine Lizenz für Ihr Add-On neu erworben hat (unabhängig davon, ob Sie Geld in Rechnung gestellt haben oder kostenlos angeboten haben).
  • Der Kanal ist die Methode, mit der ein Kunde auf die Eintragsseite Ihrer App gelangt (z. B. über den App Store oder eine benutzerdefinierte App-Werbekampagne).

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

Methode Anforderungs-URI
ERHALTEN/Bekommen https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappchannelconversions

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 Add-On-Konvertierungsdaten abrufen möchten. Ein Beispiel für eine Store-ID ist 9WZDNCRFJ3Q8. Ja
In-App-Produkt-ID Schnur Die Store-ID des Add-Ons, für das Sie Konvertierungsdaten abrufen möchten. Ja
Startdatum Datum Das Startdatum des Datumsbereichs der abzurufenden Konvertierungsdaten. Der Standardwert ist 1/1/2016. Nein
Enddatum Datum Das Enddatum im Datumsbereich der Konvertierungsdaten, die abgerufen werden sollen. 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 Anweisungen, die den Antworttext filtern. Jede Anweisung kann die Operatoren eq oder ne verwenden, und Anweisungen können mit und oder mit oderkombiniert werden. Sie können die folgenden Zeichenfolgen in den Filteranweisungen angeben. Beschreibungen finden Sie im Abschnitt Konvertierungswerte in diesem Artikel.
  • Name der Anwendung
  • Anwendungstyp
  • benutzerdefinierteKampagnenId
  • ReferrerUriDomain
  • channelType
  • Kunde speichern
  • Gerätetyp
  • Markt

Hier ist ein Beispiel für einen Filter-Parameter: filter=deviceType eq 'PC'.

 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, ist der Standardwert Tag. Nein
Sortierung nach Schnur Eine Anweisung, die die Ergebnisdatenwerte für jede Konvertierung anordnet. Die Syntax lautet orderby=field [order],field [order],.... Der field-Parameter kann eine der folgenden Zeichenfolgen sein:
  • Datum
  • Name der Anwendung
  • inAppProduktname
  • Anwendungstyp
  • benutzerdefinierteKampagnenId
  • ReferrerUriDomain
  • channelType
  • Kunde speichern
  • Gerätetyp
  • Markt

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
  • inAppProduktname
  • Anwendungstyp
  • benutzerdefinierteKampagnenId
  • ReferrerUriDomain
  • channelType
  • Kunde speichern
  • Gerätetyp
  • Markt

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

  • Datum
  • Anwendungs-ID
  • inAppProduktId
  • inAppProduktname
  • conversionCount
  • KlickZähler

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

 Nein

Beispielanfrage

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

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

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

Antwort

Antwortkörper

Wert Typ BESCHREIBUNG
Wert Array Ein Array von Objekten, die aggregierte Konvertierungsdaten für das Add-On enthalten. Weitere Informationen zu den Daten in den einzelnen Objekten finden Sie im Abschnitt Konvertierungswerte 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 oberste Parameter der Anforderung auf 10 festgelegt ist, es jedoch mehr als 10 Zeilen mit Konvertierungsdaten für die Abfrage gibt.
Gesamtzahl INT Die Gesamtanzahl der Zeilen des Abfrageergebnisses.

Konvertierungswerte

Objekte im Value Array enthalten die folgenden Werte.

Wert Typ BESCHREIBUNG
Datum Schnur Das erste Datum im Datumsbereich für die Konvertierungsdaten. 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.
In-App-Produkt-ID Schnur Die Store-ID des Add-Ons, für das Sie Konvertierungsdaten abrufen.
In-App-Produktname Schnur Der Anzeigename des Add-Ons, für das Sie Konvertierungsdaten abrufen.
Anwendungs-ID Schnur Die Store-ID der App, für die Sie Konvertierungsdaten abrufen.
Anwendungsname Schnur Der Anzeigename der App, für die Sie Konvertierungsdaten abrufen.
App-Typ Schnur Der Typ des Produkts, für das Sie Konvertierungsdaten abrufen. Für diese Methode wird der einzige unterstützte Wert Add-On.
customCampaignId Schnur Die ID-Zeichenfolge für eine benutzerdefinierte App-Werbekampagne , die der App zugeordnet ist.
Referrer-URI-Domain Schnur Gibt die Domäne an, in der der App-Eintrag mit der benutzerdefinierten App-Werbe-Kampagnen-ID aktiviert wurde.
Kanaltyp Schnur Eine der folgenden Zeichenfolgen, die den Kanal für die Konvertierung angibt:
  • CustomCampaignId
  • Store-Datenverkehr
  • Andere
storeClient Schnur Die Version des Stores, in dem die Konvertierung erfolgt ist. Derzeit ist der einzige unterstützte Wert SFC.
Gerätetyp Schnur Eine der folgenden Zeichenfolgen:
  • PC
  • Telefon
  • Console-Xbox One
  • Console-Xbox Series X
  • Iot
  • Holographisch
  • Unbekannt
Markt Schnur Der ISO 3166-Ländercode des Marktes, in dem die Konvertierung erfolgte.
Klickanzahl Zahl Die Anzahl der Klicks von Kunden auf den Link zu Ihrem App-Eintrag.
Konversionsanzahl Zahl Die Anzahl der Kundenkonvertierungen.

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/inappchannelconversions?applicationId=9NBLGGGZ5QDR&startDate=12/19/2019&endDate=12/20/2021&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

Beispielantwort

{
    "Value": [
        {
            "inAppProductId": "9NN2HW33ZB2G",
            "applicationId": "9NBLGGGZ5QDR",
            "clickCount": 220636,
            "conversionCount": 154
        },
        {
            "inAppProductId": "9PN07J0WC18B",
            "applicationId": "9NBLGGGZ5QDR",
            "clickCount": 277061,
            "conversionCount": 187
        }
    ],
    "@nextLink": "",
    "TotalCount": 2
}

Beispielanforderung

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappchannelconversions?applicationId=9NBLGGGZ5QDR&startDate=12/19/2021&endDate=12/20/2021&top=10&skip=0&groupby=date,applicationName,inAppProductName,appType,customCampaignId,referrerUriDomain,channelType,storeClient,deviceType,market
HTTP/1.1
Authorization: Bearer <your access token>

Beispielantwort

{
    "Value": [
        {
            "inAppProductId": "9WZDNCRCWW61",
            "inAppProductName": "SeasonPass0",
            "appType": "Add-On",
            "date": "2022-06-21",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "mcg_mahjong_othergames",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "BR",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW5H",
            "inAppProductName": "OEMFreePurchase",
            "appType": "Add-On",
            "date": "2022-07-06",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "mcg_solitaire_othergames",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "AT",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW5Z",
            "inAppProductName": "Episode1Combo",
            "appType": "Add-On",
            "date": "2022-07-09",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "vungle",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "CZ",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW5H",
            "inAppProductName": "OEMFreePurchase",
            "appType": "Add-On",
            "date": "2022-07-09",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "vungle",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "CZ",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW4Z",
            "inAppProductName": "Episode1Grandfathered",
            "appType": "Add-On",
            "date": "2022-07-11",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "|autosuggest",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "ES",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW5W",
            "inAppProductName": "Episode2Combo",
            "appType": "Add-On",
            "date": "2022-07-11",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "vungle",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "CZ",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW4P",
            "inAppProductName": "SeasonPass24",
            "appType": "Add-On",
            "date": "2022-07-12",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "vungle",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "CZ",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW5H",
            "inAppProductName": "OEMFreePurchase",
            "appType": "Add-On",
            "date": "2022-07-13",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "9wzdncrfjbd8",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "CA",
            "clickCount": 1,
            "conversionCount": 1
        },
        {
            "inAppProductId": "9WZDNCRCWW61",
            "inAppProductName": "SeasonPass0",
            "appType": "Add-On",
            "date": "2022-07-17",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "scom-web-store",
            "channelType": "CustomCampaignId",
            "storeClient": "SFW",
            "deviceType": "Unknown",
            "market": "US",
            "clickCount": 1,
            "conversionCount": 1
        }
    ],
    "@nextLink": "",
    "TotalCount": 9
}
  • Last updated on