Udostępnij przez

Uzyskaj dane z lejka akwizycji aplikacji

Użyj tej metody w interfejsie API analizy Microsoft Store, aby uzyskać dane lejka pozyskiwania dla aplikacji w danym zakresie dat oraz z innymi opcjonalnymi filtrami. 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/funnel

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 lejka pozyskiwania. Przykładowy identyfikator sklepu to 9WZDNCRFJ3Q8. Tak
data rozpoczęcia termin Data rozpoczęcia w zakresie dat pobierania danych lejka pozyskiwania. Wartość domyślna to bieżąca data. Nie.
data zakończenia termin Data końcowa w zakresie dat do pobrania danych z lejka sprzedażowego. Wartość domyślna to bieżąca data. Nie.
filtr sznurek Jedno lub więcej wyrażeń, które filtrują wiersze w odpowiedzi. Aby uzyskać więcej informacji, zobacz sekcję pól filtru poniżej. Nie.

 

Filtrowanie pól

Parametr filtru w żądaniu zawiera jedną lub więcej instrukcji filtrujących wiersze w odpowiedzi. Każde wyrażenie zawiera pole i wartość, które są powiązane z operatorami eq lub ne, a wyrażenia mogą być łączone za pomocą i albo lub.

Obsługiwane są następujące pola filtru. Wartości ciągu muszą być otoczone pojedynczymi cudzysłowami w parametrze filtru .

Pola formularza Opis
identyfikator kampanii Ciąg identyfikatora kampanii promującej aplikację niestandardową powiązany z pozyskiwaniem.
rynek Ciąg zawierający kod kraju ISO 3166 rynku, na którym miało miejsce nabycie.
typ urządzenia Jeden z następujących ciągów określający typ urządzenia, na którym wystąpiło przejęcie:
  • Komputer osobisty
  • Telefon
  • Console-Xbox One
  • SeriaConsole-Xbox X
  • Iot
  • Holograficzne
  • Nieznane
grupa wiekowa Jeden z następujących ciągów określających grupę wiekową użytkownika, który ukończył nabycie:
  • 0– 17
  • 18–24
  • 25– 34
  • 35– 49
  • 50 lub więcej
  • Nieznane
płeć Jeden z poniższych ciągów określający płeć użytkownika, który ukończył zakup:
  • M
  • F
  • Nieznane

Przykład zapytania

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

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>

Odpowiedź

Ciało odpowiedzi

Wartość Typ Opis
Wartość układ Tablica obiektów, które zawierają dane lejka sprzedażowego dla aplikacji. Aby uzyskać więcej informacji na temat danych w każdym obiekcie, zobacz sekcję wartości lejka poniżej.
Łączna liczba int (integer) Całkowita liczba obiektów w tablicy Value.

Wartości lejka

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

Wartość Typ Opis
Typ metryki sznurek Jeden z następujących ciągów określający typ danych lejka, który znajduje się w tym obiekcie:
  • Widok strony
  • akwizycja
  • Instalowanie
  • Użycie
LiczbaUżytkowników sznurek Liczba użytkowników, którzy wykonali krok lejka, określony wartością MetricType.

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

Przykładowa odpowiedź

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

Przykładowe żądanie

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>

Przykładowa odpowiedź

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