Udostępnij przez

Uzyskaj konwersje aplikacji według kanału

Użyj tej metody w interfejsie API analizy sklepu Microsoft Store, aby uzyskać agregację konwersji według kanału dla aplikacji w danym zakresie dat i innych opcjonalnych filtrach.

  • Konwersja oznacza, że klient (zalogowany przy użyciu konta Microsoft) ma nowo uzyskaną licencję na aplikację (niezależnie od tego, czy pobrano pieniądze, czy zaoferowano ją bezpłatnie).
  • Kanał to sposób, w jaki klient dotarł do strony z listą Twojej aplikacji (na przykład za pośrednictwem Sklepu lub kampanii promocyjnej aplikacji niestandardowej).

Ta informacja jest również dostępna w Raporcie o Pozyskaniach w Centrum partnerskim.

Wymagania wstępne

Aby użyć tej metody, należy najpierw wykonać następujące czynności:

  • Jeśli jeszcze tego nie zrobiłeś, wykonaj wszystkie wymagania wstępne i dla API analizy Microsoft Store.
  • Uzyskaj token dostępu usługi Azure AD do użycia w nagłówku żądania dla tej metody. Po uzyskaniu tokenu dostępu należy 60 minut używać go przed jego wygaśnięciem. Po wygaśnięciu tokenu można uzyskać nowy.

Żądanie

Składnia żądania

Metoda Żądanie URI
POBIERZ https://manage.devcenter.microsoft.com/v1.0/my/analytics/appchannelconversions

Nagłówek żądania

Nagłówek Typ Opis
Autoryzacja sznurek To jest wymagane. Token dostępu usługi Azure AD w postaci tokenu typu Bearer <>.

Parametry żądania

Parametr Typ Opis Wymagane
applicationId (identyfikator aplikacji) sznurek Identyfikator sklepu aplikacji, dla której chcesz pobrać dane konwersji. Przykładowy identyfikator sklepu to 9WZDNCRFJ3Q8. Tak
data rozpoczęcia termin Data początkowa w zakresie dat do pobierania danych konwersji. Wartość domyślna to 1.1.2016. Nie.
data zakończenia termin Data końcowa przedziału dat do pobrania danych konwersji. Wartość domyślna to bieżąca data. Nie.
Do góry int (integer) Liczba wierszy danych, które należy zwrócić w żądaniu. Wartość maksymalna i wartość domyślna, jeśli nie zostanie określona, to 10000. Jeśli w zapytaniu znajduje się więcej wierszy, treść odpowiedzi zawiera następny link, którego można użyć do żądania następnej strony danych. Nie.
pominąć int (integer) Liczba wierszy do pominięcia w zapytaniu. Użyj tego parametru, aby przeglądać duże zestawy danych. Na przykład top=10000 i skip=0 pobiera pierwsze 10000 wierszy danych, top=10000 i skip=10000 pobiera następne 10000 wierszy danych itd. Nie.
filtr sznurek Co najmniej jedno lub więcej wyrażeń filtrujących zawartość odpowiedzi. Każda instrukcja może używać operatorów eq lub ne, a instrukcje można łączyć przy użyciu i lub lub. W instrukcjach filter można określić następujące ciągi. Aby uzyskać opisy, zobacz sekcję na temat wartości konwersji w tym artykule.
  • applicationName (nazwa_aplikacji)
  • appType
  • customCampaignId
  • refererUriDomain
  • typKanału
  • klient sklepu
  • typ urządzenia
  • rynek

Oto przykład parametru filtru : filter=deviceType eq 'PC'.

 Nie.
poziom agregacji sznurek Określa zakres czasu, dla którego mają być pobierane agregowane dane. Może być jednym z następujących ciągów: dzień, tydzień lub miesiąc. Jeśli jest to nieokreślone, wartość domyślna to dzień. Nie.
sortowanie według sznurek Instrukcja, która porządkuje wartości danych wynikowych dla każdej konwersji. Składnia to orderby=field [order],field [order],.... Parametr field może być jednym z następujących ciągów:
  • daty
  • applicationName (nazwa_aplikacji)
  • appType
  • customCampaignId
  • refererUriDomain
  • typKanału
  • klient sklepu
  • typ urządzenia
  • rynek

Parametr order jest opcjonalny i może być asc lub desc w celu określenia kolejności rosnącej lub malejącej dla każdego pola. Wartość domyślna to asc.

Oto przykładowy ciąg orderby: orderby=date,market

 Nie.
grupowanie sznurek Instrukcja, która stosuje agregację danych tylko do określonych pól. Możesz określić następujące pola:
  • daty
  • applicationName (nazwa_aplikacji)
  • appType
  • customCampaignId
  • refererUriDomain
  • typKanału
  • klient sklepu
  • typ urządzenia
  • rynek

Zwrócone wiersze danych będą zawierać pola określone w parametrze groupby , a także następujące:

  • daty
  • applicationId (identyfikator aplikacji)
  • liczba konwersji
  • liczba kliknięć

Parametr groupby może być używany z parametrem aggregationLevel . Na przykład: groupby=ageGroup,market&aggregationLevel=week

 Nie.

Przykład zapytania

W poniższym przykładzie pokazano kilka żądań pobierania danych konwersji aplikacji. Zastąp wartość applicationId identyfikatorem sklepu dla aplikacji.

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

Odpowiedź

Ciało odpowiedzi

Wartość Typ Opis
Wartość układ Tablica obiektów zawierających agregujące dane konwersji dla aplikacji. Aby uzyskać więcej informacji na temat danych w każdym obiekcie, zobacz sekcję wartości konwersji poniżej.
@nextLink sznurek Jeśli istnieją dodatkowe strony danych, ten ciąg zawiera identyfikator URI, którego można użyć do żądania następnej strony danych. Na przykład ta wartość jest zwracana, jeśli górny parametr żądania jest ustawiony na 10, ale dane konwersji dla zapytania obejmują więcej niż 10 wierszy.
Łączna liczba int (integer) Całkowita liczba wierszy w wyniku danych dla zapytania.

Wartości konwersji

Obiekty w tablicy Value zawierają następujące wartości.

Wartość Typ Opis
termin sznurek Pierwsza data w przedziale dat dla danych konwersji. Jeśli żądanie określiło jeden dzień, ta wartość to ta data. Jeśli w żądaniu określono tydzień, miesiąc lub inny zakres dat, ta wartość jest pierwszą datą w tym zakresie dat.
applicationId (identyfikator aplikacji) sznurek Identyfikator sklepu aplikacji, dla której pobierasz dane konwersji.
Nazwa aplikacji sznurek Nazwa wyświetlana aplikacji, dla której pobierasz dane konwersji.
typ aplikacji sznurek Typ produktu, dla którego pobierasz dane konwersji. W przypadku tej metody jedyną obsługiwaną wartością jest App.
IdentyfikatorWłasnejKampanii sznurek Ciąg identyfikacyjny kampanii promocyjnej aplikacji niestandardowej powiązany z tą aplikacją.
odwołującyUriDomain sznurek Określa domenę, w której aktywowano listę aplikacji z identyfikatorem kampanii promocyjnej niestandardowej aplikacji.
typKanału sznurek Jeden z następujących ciągów określający kanał konwersji:
  • CustomCampaignId
  • Ruch w sklepie
  • Inne
klient sklepu sznurek Wersja sklepu, w którym wystąpiła konwersja. Obecnie jedyną obsługiwaną wartością jest SFC.
typ urządzenia sznurek Jeden z następujących ciągów:
  • Komputer osobisty
  • Telefon
  • Console-Xbox One
  • SeriaConsole-Xbox X
  • Iot
  • Holograficzne
  • Nieznane
rynek sznurek Kod kraju ISO 3166 rynku, na którym nastąpiła konwersja.
liczba kliknięć Liczba Liczba kliknięć klientów w link do strony twojej aplikacji.
liczba konwersji Liczba Liczba konwersji klientów.

Przykład żądania i odpowiedzi

Poniższe fragmenty kodu przedstawiają przykładowe żądanie i treść odpowiedzi JSON dla tego żądania.

Przykładowe żądanie

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appchannelconversions?applicationId=9NBLGGGZ5QDR&startDate=06/23/2022&endDate=07/21/2022&top=10&skip=0
HTTP/1.1
Authorization: Bearer <your access token>

Przykładowa odpowiedź

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "clickCount": 3089,
            "conversionCount": 14
        }
    ],
    "@nextLink": "",
    "TotalCount": 1
}

Przykładowe żądanie

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/appchannelconversions?applicationId=9NBLGGGZ5QDR&startDate=06/19/2022&endDate=07/21/2022&skip=0&groupby=date,applicationName,customCampaignId,referrerUriDomain,channelType,storeClient,deviceType,market&filter=market eq 'US'
HTTP/1.1
Authorization: Bearer <your access token>

Przykładowa odpowiedź

{
    "Value": [
        {
            "date": "2022-06-19",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "",
            "referrerUriDomain": "Universal Client Store",
            "channelType": "Store Traffic",
            "storeClient": "SFC",
            "deviceType": "PC",
            "market": "US",
            "clickCount": 13,
            "conversionCount": 0
        },
        {
            "date": "2022-06-20",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "",
            "referrerUriDomain": "Universal Client Store",
            "channelType": "Store Traffic",
            "storeClient": "SFC",
            "deviceType": "PC",
            "market": "US",
            "clickCount": 6,
            "conversionCount": 0
        },
        {
            "date": "2022-06-21",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "",
            "referrerUriDomain": "Universal Client Store",
            "channelType": "Store Traffic",
            "storeClient": "SFC",
            "deviceType": "PC",
            "market": "US",
            "clickCount": 4,
            "conversionCount": 0
        },
        {
            "date": "2022-06-22",
            "applicationId": "9NBLGGGZ5QDR",
            "applicationName": "Contoso Demo",
            "customCampaignId": "",
            "referrerUriDomain": "Universal Client Store",
            "channelType": "Store Traffic",
            "storeClient": "SFC",
            "deviceType": "PC",
            "market": "US",
            "clickCount": 4,
            "conversionCount": 0
        },
    ],
    "@nextLink": "",
    "TotalCount": 4
}
  • Last updated on