Получение аналитических данных
Используйте этот метод в API аналитики Microsoft Store для получения аналитических данных, связанных с метриками приобретения, работоспособности и использования для приложения в течение заданного диапазона дат и других необязательных фильтров. Эти сведения также доступны в отчете Insights в Центре партнеров.
Предварительные требования
Для использования этого метода сначала необходимо сделать следующее:
- Если вы еще не сделали этого, выполните все необходимые условия для API аналитики для Microsoft Store.
- Получите маркер доступа Azure AD, который будет использоваться в заголовке запроса этого метода. После получения маркера доступа у вас будет 60 минут, чтобы использовать его до истечения срока действия. После истечения срока действия маркера можно получить новый маркер.
Запрос
Синтаксис запроса
| Метод | Универсальный код ресурса (URI) запроса |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights |
Заголовок запроса
| Заголовок | Тип | Описание |
|---|---|---|
| Авторизация | строка | Обязательный. Маркер доступа Azure AD в видемаркера>носителя<. |
Параметры запроса
| Параметр | Тип | Описание | Обязательно |
|---|---|---|---|
| applicationId | строка | Код приложения в Магазине, для которого требуется получить аналитические данные. Если этот параметр не указан, текст ответа будет содержать аналитические данные для всех приложений, зарегистрированных в вашей учетной записи. | Нет |
| startDate | Дата | Начальная дата в диапазоне дат извлекаемых аналитических данных. По умолчанию используется текущая дата минус 30 дней. | Нет |
| endDate | Дата | Конечная дата в диапазоне дат извлекаемых данных аналитики. По умолчанию используется текущая дата. | Нет |
| фильтр | строка | Одно или несколько выражений для фильтрации строк в ответе. Каждое выражение содержит имя поля из тела ответа и значение, которое связано с помощью операторов eq или ne; выражения можно комбинировать, используя операторы and или or. В параметре filter строковые значения должны быть заключены в одиночные кавычки. Например, filter=dataType eq 'acquisition'. Можно указать следующие поля фильтра:
|
Да |
Пример запроса
В следующем примере показан запрос на получение аналитических данных. Замените значение applicationId кодом продукта в Магазине для вашего приложения.
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>
Ответ
Текст ответа
| Значение | Тип | Описание |
|---|---|---|
| Значение | array | Массив объектов , содержащих аналитические данные для приложения. Дополнительные сведения о данных в каждом объекте см. в разделе Аналитические значения ниже. |
| TotalCount | INT | Общее количество строк в результирующих данных для запроса. |
Аналитические значения
Элементы в массиве Value содержат следующие значения.
| Значение | Тип | Описание |
|---|---|---|
| applicationId | строка | Код приложения в Магазине, для которого вы извлеките аналитические данные. |
| insightDate | строка | Дата, в которую мы определили изменение в определенной метрике. Эта дата представляет собой конец недели, в которой мы обнаружили значительное увеличение или уменьшение метрики по сравнению с неделей ранее. |
| dataType | строка | Одна из следующих строк, задающая общую область аналитики, описываемую в этой аналитике:
|
| insightDetail | array | Одно или несколько значений InsightDetail , представляющих сведения для текущей аналитики. |
Значения InsightDetail
| Значение | Тип | Описание |
|---|---|---|
| FactName | строка | Одно из следующих значений, указывающее метрику, описываемую текущей аналитикой или текущим измерением, на основе значения dataType .
|
| Поддимени | array | Один или несколько объектов, описывающих одну метрику для аналитических сведений. |
| PercentChange | строка | Процент изменения метрики для всей клиентской базы. |
| DimensionName | строка | Имя метрики, описанной в текущем измерении. Примеры: EventType, Market, DeviceType, PackageVersion, AcquisitionType, AgeGroup и Gender. |
| DimensionValue | строка | Значение метрики, описанное в текущем измерении. Например, если DimensionName имеет значение EventType, DimensionValue может быть аварийно завершена или зависает. |
| FactValue | строка | Абсолютное значение метрики на дату обнаружения аналитических сведений. |
| Направление | строка | Направление изменения (положительное или отрицательное). |
| Дата | строка | Дата, в которую мы определили изменение, связанное с текущим аналитическим представлением или текущим измерением. |
Примечание
Полученные изменения аналитики будут доступны только за последние 30 дней с данными о покупках, работоспособности и (или) использовании.
Пример запроса и ответа
В следующих фрагментах кода демонстрируется пример запроса и текст ответа JSON для этих запросов.
Пример запроса
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>
Пример ответа
{
"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
}
Связанные темы
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по