Получите аналитические данные для настольного приложения

2025-06-10

Используйте этот метод в API аналитики Microsoft Store, чтобы получить аналитические данные, связанные с метриками работоспособности настольного приложения, добавленного в программу приложений для настольных ПК Windows . Эти данные также доступны в отчете о состоянии здоровья для настольных приложений в Центре партнеров.

Предпосылки

Чтобы использовать этот метод, сначала необходимо выполнить следующие действия:

Если это еще не сделано, выполните все предварительные требования для API аналитики Microsoft Store.
Получите маркер доступа Azure AD для использования в заголовке запроса для этого метода. После получения маркера доступа у вас есть 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия токена можно получить новый токен.

Просьба

Синтаксис запроса

Метод	Запрос URI
ПОЛУЧАЙ	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/insights`

Заголовок запроса

Заголовок	Тип	Описание
Авторизация	струна	Обязательное. Токен доступа Azure AD в формате Bearer<token>.

Параметры запроса

Параметр	Тип	Описание	Обязательно
applicationId	струна	Идентификатор продукта настольного приложения, для которого требуется получить аналитические данные. Чтобы получить идентификатор продукта классического приложения, откройте любой отчет аналитики для классического приложения в Центре партнеров (например, отчет о работоспособности) и получите идентификатор продукта из URL-адреса. Если этот параметр не указан, текст ответа будет содержать данные аналитики для всех приложений, зарегистрированных в вашей учетной записи.	нет
Дата начала	дата	Дата начала в диапазоне дат данных аналитики, которые нужно получить. Значение по умолчанию — 30 дней до текущей даты.	нет
Дата окончания	дата	Дата окончания в диапазоне дат для получения данных аналитики. Значение по умолчанию — текущая дата.	нет
фильтр	струна	Одна или несколько инструкций, которые фильтруют строки в ответе. Каждое выражение содержит имя поля из текста ответа и значение, связанное с операторами eq или ne, и выражения могут быть объединены с помощью и или или. Строковые значения должны быть окружены одними кавычками в параметре фильтра . Например, filter=dataType eq 'acquisition'. В настоящее время этот метод поддерживает только фильтр состояние.	нет

Пример запроса

В следующем примере показано запрос на получение аналитических данных. Замените значение applicationId соответствующим значением для настольного приложения.

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>

Ответ

Основная часть ответа

Ценность	Тип	Описание
Ценность	массив	Массив объектов, содержащих данные аналитики для приложения. Дополнительные сведения о данных в каждом объекте см. в разделе Аналитические значения ниже.
Общее количество	инт	Общее количество строк в результатах данных для запроса.

Значения аналитических сведений

Элементы в массиве значений содержат следующие значения.

Ценность	Тип	Описание
applicationId	струна	Идентификатор продукта настольного приложения, для которого вы получили данные аналитики.
Дата инсайта	струна	Дата, в которой мы определили изменение определенной метрики. Эта дата представляет конец недели, в которой мы обнаружили значительное увеличение или уменьшение метрики по сравнению с этой неделей.
тип данных	струна	Строка, указывающая общую область аналитики, о которой информирует данный инсайт. В настоящее время этот метод поддерживает только здоровье.
детали инсайта	массив	Одно или несколько значений InsightsDetail , представляющих сведения для текущего анализа.

Значения InsightDetail

Ценность	Тип	Описание
Название факта	струна	Строка, указывающая метрику, описываемую текущим анализом или текущим измерением. В настоящее время этот метод поддерживает только значение HitCount.
Подразмерности	массив	Один или несколько объектов, описывающих одну метрику для анализа.
ИзменениеПроцента	струна	Процент изменения метрики по всей вашей клиентской базе.
НазваниеИзмерения	струна	Имя метрики, описанной в текущем измерении. Примерами являются EventType, Market, DeviceTypeи PackageVersion.
ЗначениеРазмерности	струна	Значение метрики, описанной в текущем измерении. Например, если DimensionName — EventType, DimensionValue может быть сбой или зависание.
ЗначениеФакта	струна	Абсолютное значение метрики на дату обнаружения аналитических сведений.
Направление	струна	Направление изменения (положительное или отрицательное).
Дата	струна	Дата, в которой мы определили изменение, связанное с текущим анализом или текущим измерением.

Пример ответа

В следующем примере показан пример текста ответа JSON для этого запроса.

{
  "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
}