Uzyskiwanie danych analitycznych

Użyj tej metody w interfejsie API analizy sklepu Microsoft Store, aby uzyskać szczegółowe informacje dotyczące pozyskiwania, kondycji i metryk użycia aplikacji w danym zakresie dat i innych opcjonalnych filtrach. Te informacje są również dostępne w raporcie Insights 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/insights`

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 wglądu. Jeśli nie określisz tego parametru, treść odpowiedzi będzie zawierać dane analityczne dla wszystkich aplikacji powiązanych z twoim kontem.	Nie.
data rozpoczęcia	termin	Data początkowa zakresu danych analitycznych do pobrania. Wartość domyślna to 30 dni przed bieżącą datą.	Nie.
data zakończenia	termin	Data końcowa w zakresie danych zestawienia do pobrania. Wartość domyślna to bieżąca data.	Nie.
filtr	sznurek	Jedno lub więcej wyrażeń, które filtrują wiersze w odpowiedzi. Każda instrukcja zawiera nazwę pola z treści odpowiedzi i wartości, które są skojarzone z operatorami eq lub ne, a instrukcje mogą być łączone przy użyciu i lub lub. Wartości ciągu muszą być otoczone pojedynczymi cudzysłowami w parametrze filtru . Na przykład filter=dataType eq „acquisition”. Możesz określić następujące pola filtru: nabycie zdrowie użycia	Tak

Przykład zapytania

W poniższym przykładzie pokazano żądanie uzyskania danych analitycznych. Zastąp wartość applicationId identyfikatorem sklepu dla aplikacji.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights?applicationId=9NBLGGGZ5QDR&startDate=6/1/2018&endDate=6/15/2018&filter=dataType eq 'acquisition' or dataType eq 'health' HTTP/1.1
Authorization: Bearer <your access token>

Odpowiedź

Ciało odpowiedzi

Wartość	Typ	Opis
Wartość	układ	Tablica obiektów zawierających dane analityczne na potrzeby aplikacji. Aby uzyskać więcej informacji na temat danych w każdym obiekcie, zobacz sekcję wartości informacji poniżej.
Łączna liczba	int (integer)	Całkowita liczba wierszy w wyniku danych dla zapytania.

Wartości wiedzy

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

Wartość	Typ	Opis
applicationId (identyfikator aplikacji)	sznurek	Identyfikator sklepu aplikacji, dla której pobierasz dane analiz.
insightDate (data wglądu)	sznurek	Data, w której zidentyfikowaliśmy zmianę określonej metryki. Ta data reprezentuje koniec tygodnia, w którym wykryliśmy znaczny wzrost lub spadek metryki w porównaniu z tygodniem wcześniej.
typ danych	sznurek	Jeden z następujących ciągów określający ogólny obszar analizy, który opisuje ten wgląd: nabycie zdrowie użycia
szczegóły spostrzeżeń	układ	Co najmniej jedna wartość InsightDetail reprezentująca szczegóły bieżącego wglądu.

Wartości szczegółowych informacji

Wartość	Typ	Opis
Nazwa faktu	sznurek	Na podstawie wartości dataType, jedna z poniższych wartości wskazuje metrykę, którą opisuje bieżący wgląd lub bieżący wymiar. Dla kondycji zdrowotnej , ta wartość jest zawsze HitCount. W przypadku pozyskiwaniata wartość jest zawsze AcquisitionQuantity. Dla zastosowania , ta wartość należy do jednego z następujących ciągów: CodzienniAktywni użytkownicy CzasZaangażowaniaMinuty DziennieAktywneUrządzenia CodziennieNowi użytkownicy LiczbaCodziennychSesji
Podwymiary	układ	Jeden lub więcej obiektów opisujących pojedynczą metrykę dla analizy.
Zmiana procentowa	sznurek	Wartość procentowa zmiany metryki w całej bazie klientów.
Nazwa wymiaru	sznurek	Nazwa metryki opisanej w bieżącym wymiarze. Przykłady to EventType, Market, DeviceType, PackageVersion, AcquisitionType, AgeGroup i Gender.
Wartość wymiaru	sznurek	Wartość metryki opisanej w bieżącym wymiarze. Na przykład, jeśli DimensionName to EventType, DimensionValue może być awaria lub zawieszenie.
Wartość Faktów	sznurek	Wartość bezwzględna metryki w dniu, gdy wykryto spostrzeżenie.
Kierunek	sznurek	Kierunek zmiany (dodatnie lub ujemne).
Data kalendarzowa	sznurek	Data, kiedy zidentyfikowaliśmy zmianę związaną z bieżącym spostrzeżeniem lub bieżącym wymiarem.

Uwaga / Notatka

Pobrane zmiany w danych analitycznych będą dotyczyć tylko ostatnich 30 dni pozyskiwań, kondycji i/lub danych dotyczących użycia.

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/insights?applicationId=9NBLGGGZ5QDR&startDate=7/12/2022&endDate=7/29/2022&filter=dataType eq 'acquisition' or dataType eq 'health'
HTTP/1.1
Authorization: Bearer <your access token>

Przykładowa odpowiedź

{
    "Value": [
        {
            "id": "8cdb672c7893bd33a3dec48ededdc676602a1361f3209ab4f3e0982672fc198f",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-27T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-27 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "DeviceType",
                            "DimensionValue": "Tablet",
                            "Date": "2022-07-27 00:00:00",
                            "Direction": "Positive",
                            "PercentChange": 16.091954022988507,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 28.0
                        }
                    ]
                }
            ]
        },
        {
            "id": "6b8849ecb043c6e5ecdd1c20040c0a371e9ab176eff77f7312b0489e19379225",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-26T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-26 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "DeviceType",
                            "DimensionValue": "Tablet",
                            "Date": "2022-07-26 00:00:00",
                            "Direction": "Positive",
                            "PercentChange": 28.048780487804876,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 30.0
                        }
                    ]
                }
            ]
        },
        {
            "id": "93115e855fec507385bab17251f49c33bcbc1b62c603e5c7863e327ba94bf160",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-20T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-20 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "Market",
                            "DimensionValue": "GB",
                            "Date": "2022-07-20 00:00:00",
                            "Direction": "Negative",
                            "PercentChange": 3.3035714285714284,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 158.0
                        }
                    ]
                }
            ]
        },
        {
            "id": "4814abe710042a2798b453d8821909c246c389dde814e6678da7189211410604",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-24T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-24 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "Market",
                            "DimensionValue": "DO",
                            "Date": "2022-07-24 00:00:00",
                            "Direction": "Negative",
                            "PercentChange": 13.533834586466165,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 8.0
                        }
                    ]
                }
            ]
        },
        {
            "id": "7941070bb17904f3ef4e19de9659110cb52e18ecfb637ad724e2da749445a860",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-21T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-21 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "Market",
                            "DimensionValue": "AT",
                            "Date": "2022-07-21 00:00:00",
                            "Direction": "Positive",
                            "PercentChange": 0.0,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 17.0
                        }
                    ]
                },
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-21 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "Market",
                            "DimensionValue": "SE",
                            "Date": "2022-07-21 00:00:00",
                            "Direction": "Negative",
                            "PercentChange": 21.686746987951807,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 5.0
                        }
                    ]
                }
            ]
        },
        {
            "id": "55905f5458617b65669eb115cc28ebd7296841bd2ff3f8e2546ade1d5e93f68d",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-13T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "AcquisitionType",
                    "DimensionValue": "Free",
                    "Date": "2022-07-13 00:00:00",
                    "FactName": "AcquisitionQuantity",
                    "SubDimensions": [
                        {
                            "DimensionName": "Market",
                            "DimensionValue": "LK",
                            "Date": "2022-07-13 00:00:00",
                            "Direction": "Negative",
                            "PercentChange": 11.111111111111111,
                            "FactName": "AcquisitionQuantity",
                            "FactQuantity": 9.0
                        }
                    ]
                }
            ]
        },
        {
            "id": "9ce9317bf4d0f903de51a49d00a07cf4b4a8ac4457fd1e2886493bd38ceac0b7",
            "applicationId": "9NBLGGGZ5QDR",
            "insightDate": "2022-07-19T00:00:00",
            "dataType": "acquisition",
            "insightDetail": [
                {
                    "DimensionName": "Acquisition",
                    "DimensionValue": "Free",
                    "Date": "2022-07-19 00:00:00",
                    "Direction": "Negative",
                    "PercentChange": 12.188725230475788,
                    "FactName": "AcquisitionQuantity",
                    "FactQuantity": 2470,
                    "SubDimensions": []
                }
            ]
        }
    ],
    "TotalCount": 7
}

Sprzężenie zwrotne

Czy ta strona była pomocna?

Last updated on 2025-06-20