Obtención de datos de información
Usa este método en la API de análisis de Microsoft Store para obtener información relacionada con adquisiciones, estado y métricas de uso de una aplicación durante un intervalo de fechas determinado y otros filtros opcionales. Esta información también está disponible en el informe Insights del Centro de partners.
Requisitos previos
Para usar este método, primero debes hacer lo siguiente:
- Si aún no lo has hecho, completa todos los requisitos previos de la API de análisis de Microsoft Store.
- Consigue un token de acceso a Azure AD para utilizarlo en el encabezado de solicitud de este método. Una vez que haya obtenido un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.
Solicitar
Sintaxis de la solicitud
| Método | URI de solicitud |
|---|---|
| GET | https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights |
Encabezado de solicitud
| Encabezado | Tipo | Descripción |
|---|---|---|
| Autorización | string | Necesario. Token de acceso de Azure AD con el formato Token<de portador>. |
Parámetros de solicitud
| Parámetro | Tipo | Descripción | Obligatorio |
|---|---|---|---|
| applicationId | string | El identificador de la Tienda de la aplicación para la que quieres recuperar datos de información. Si no especifica este parámetro, el cuerpo de la respuesta contendrá datos de información de todas las aplicaciones registradas en su cuenta. | No |
| startDate | date | Fecha de inicio en el intervalo de fechas de los datos de información que se van a recuperar. El valor predeterminado es 30 días antes de la fecha actual. | No |
| endDate | date | Fecha de finalización del intervalo de fechas de los datos de información que se van a recuperar. La fecha actual es el valor predeterminado. | No |
| filter | string | Una o varias instrucciones que filtran las filas de la respuesta. Cada instrucción contiene un nombre de campo del cuerpo de la respuesta y el valor que están asociados a los operadores eq o ne, y las instrucciones se pueden combinar mediante y u o. Los valores de cadena deben estar entre comillas simples en el parámetro de filtro. Por ejemplo, filter=dataType eq 'acquisition'. Puede especificar los siguientes campos de filtro:
|
Sí |
Ejemplo de solicitud
En el ejemplo siguiente se muestra una solicitud para obtener datos de información. Reemplaza el valor applicationId por el Id. de Store de tu aplicación.
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>
Respuesta
Cuerpo de la respuesta
| Valor | Tipo | Descripción |
|---|---|---|
| Valor | array | Matriz de objetos que contienen datos de información para la aplicación. Para obtener más información sobre los datos de cada objeto, consulte la sección Valores de información a continuación. |
| TotalCount | int | Número total de filas que figura en el resultado de datos de la consulta. |
Valores de información
Los elementos de la matriz Value contienen los valores siguientes.
| Valor | Tipo | Descripción |
|---|---|---|
| applicationId | string | El identificador de la Tienda de la aplicación para la que estás recuperando datos de información. |
| insightDate | string | Fecha en la que identificamos el cambio en una métrica específica. Esta fecha representa el final de la semana en la que hemos detectado un aumento o una disminución significativos en una métrica en comparación con la semana anterior. |
| dataType | string | Una de las siguientes cadenas que especifica el área de análisis general que describe esta información:
|
| insightDetail | array | Uno o más valores de InsightDetail que representan los detalles de la información actual. |
Valores de InsightDetail
| Valor | Tipo | Descripción |
|---|---|---|
| FactName | string | Uno de los siguientes valores que indica la métrica que describe la información actual o la dimensión actual, en función del valor dataType .
|
| SubDimensiones | array | Uno o varios objetos que describen una sola métrica para la información. |
| PercentChange | string | Porcentaje que cambió la métrica en toda la base de clientes. |
| DimensionName | string | Nombre de la métrica descrita en la dimensión actual. Algunos ejemplos son EventType, Market, DeviceType, PackageVersion, AcquisitionType, AgeGroup y Gender. |
| DimensionValue | string | Valor de la métrica que se describe en la dimensión actual. Por ejemplo, si DimensionName es EventType, DimensionValue podría bloquearse o bloquearse. |
| FactValue | string | Valor absoluto de la métrica en la fecha en que se detectó la información. |
| Dirección | string | Dirección del cambio (positivo o negativo). |
| Date | string | Fecha en la que identificamos el cambio relacionado con la información actual o la dimensión actual. |
Nota:
Los cambios de Insights recuperados solo serán durante los últimos 30 días de adquisiciones, estado o datos de uso.
Ejemplo de solicitud y respuesta
En los fragmentos de código siguientes se muestran algunos ejemplos de solicitud y del cuerpo de la respuesta en formato JSON de esa solicitud.
Solicitud de muestra
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>
Respuesta de ejemplo
{
"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
}