Share via

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

  • Статья

Используйте этот метод в 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-адресу. Если этот параметр не указан, текст ответа будет содержать аналитические данные для всех приложений, зарегистрированных в вашей учетной записи. Нет
startDate Дата Начальная дата в диапазоне дат извлекаемых данных аналитики. По умолчанию используется текущая дата минус 30 дней. Нет
endDate Дата Конечная дата в диапазоне дат извлекаемых данных аналитики. По умолчанию используется текущая дата. Нет
фильтр строка Одно или несколько выражений для фильтрации строк в ответе. Каждое выражение содержит имя поля из тела ответа и значение, которое связано с помощью операторов eq или ne; выражения можно комбинировать, используя операторы and или or. В параметре filter строковые значения должны быть заключены в одиночные кавычки. Например, 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>

Ответ

Текст ответа

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

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

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

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

Значения InsightDetail

Значение Тип Описание
FactName строка Строка, указывающая метрику, описываемую текущей аналитикой или текущим измерением. В настоящее время этот метод поддерживает только значение HitCount.
SubDimensions array Один или несколько объектов, описывающих одну метрику для аналитики.
PercentChange строка Процент изменения метрики для всей клиентской базы.
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
}