Udostępnij przez

Uzyskaj szczegółowe dane dla aplikacji desktopowej

Użyj tej metody w interfejsie API Microsoft Store, aby uzyskać szczegółowe informacje dotyczące metryk zdrowotnych dla aplikacji desktopowej, którą dodałeś do programu Aplikacja klasyczna systemu Windows. Te dane są również dostępne w raporcie Zdrowie dla aplikacji na komputer 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/desktop/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 produktu aplikacji desktopowej, dla której chcesz uzyskać dane analityczne. Aby uzyskać identyfikator produktu aplikacji komputerowej, otwórz dowolny raport z analizy aplikacji komputerowej w Centrum partnerskim (na przykład raport kondycji ) i pobierz identyfikator produktu z adresu URL. 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”.

Obecnie ta metoda obsługuje tylko kondycji filtru.

 Nie.

Przykład zapytania

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

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/insights?applicationId=10238467886765136388&startDate=6/1/2018&endDate=6/15/2018&filter=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 produktu aplikacji desktopowej, dla której pobrano wyniki.
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 Ciąg określający ogólny obszar analityczny, który jest przedmiotem tej informacji. Obecnie ta metoda obsługuje tylko zdrowie.
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 Ciąg wskazujący metrykę, którą opisuje bieżący wgląd lub bieżący wymiar. Obecnie ta metoda obsługuje tylko wartość HitCount.
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 obejmują EventType, Market, DeviceTypei PackageVersion.
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.

Przykład odpowiedzi

W poniższym przykładzie pokazano przykładową treść odpowiedzi JSON dla tego żądania.

{
  "Value": [
    {
      "applicationId": "9NBLGGGZ5QDR",
      "insightDate": "2018-06-03T00:00:00",
      "dataType": "health",
      "insightDetail": [
        {
          "FactName": "HitCount",
          "SubDimensions": [
            {
              "FactName:": "HitCount",
              "PercentChange": "21",
              "DimensionValue:": "DE",
              "FactValue": "109",
              "Direction": "Positive",
              "Date": "6/3/2018 12:00:00 AM",
              "DimensionName": "Market"
            }
          ],
          "DimensionValue": "crash",
          "Date": "6/3/2018 12:00:00 AM",
          "DimensionName": "EventType"
        },
        {
          "FactName": "HitCount",
          "SubDimensions": [
            {
              "FactName:": "HitCount",
              "PercentChange": "71",
              "DimensionValue:": "JP",
              "FactValue": "112",
              "Direction": "Positive",
              "Date": "6/3/2018 12:00:00 AM",
              "DimensionName": "Market"
            }
          ],
          "DimensionValue": "hang",
          "Date": "6/3/2018 12:00:00 AM",
          "DimensionName": "EventType"
        },
      ],
      "insightId": "9CY0F3VBT1AS942AFQaeyO0k2zUKfyOhrOHc0036Iwc="
    }
  ],
  "@nextLink": null,
  "TotalCount": 2
}
  • Last updated on