Поделиться через

Получение аналитических данных о классическом приложении

  • Статья

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

Необходимые компоненты

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

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

Запросить

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

Способ URI запроса
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/insights

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

Верхний колонтитул Тип Описание
Авторизация строка Обязательный. Маркер доступа Azure AD в маркере> носителя<формы.

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

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

В настоящее время этот метод поддерживает только работоспособности фильтра.

 No

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

В следующем примере показано запрос на получение аналитических данных. Замените значение 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>

Response

Текст ответа

Значение Тип Описание
Значение array Массив объектов, содержащих данные аналитики для приложения. Дополнительные сведения о данных в каждом объекте см . в разделе "Сведения о значениях " ниже.
TotalCount INT Общее количество строк в результатах данных для запроса.

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

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

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

Значения InsightsDetail

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

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

В следующем примере показан пример текста ответа 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
}