Obtención de datos analíticos

2025-06-10

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 en el Centro de Socios.

Prerrequisitos

Para usar este método, primero debe hacer lo siguiente:

Si aún no lo ha hecho, complete todos los requisitos previos para la API de análisis de Microsoft Store.
Obtenga un token de acceso de Azure AD para usarlo en el encabezado de solicitud para este método. Después de obtener un token de acceso, tiene 60 minutos para usarlo antes de que expire. Una vez que expire el token, puede obtener uno nuevo.

Solicitud

Sintaxis de la solicitud

Método	Solicitud de URI
OBTENER	`https://manage.devcenter.microsoft.com/v1.0/my/analytics/insights`

Cabecera de solicitud

Cabecera	Tipo	Descripción
Autorización	cuerda / cadena	Obligatorio. El token de acceso de Azure AD en la forma Bearer<token>.

Parámetros de solicitud

Parámetro	Tipo	Descripción	Obligatorio
applicationId	cuerda / cadena	La identificación de la tienda de la aplicación para la cual deseas recuperar datos. 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
Fecha de inicio	fecha	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
fecha de finalización	fecha	Fecha de finalización del intervalo de fechas de los datos de análisis que se van a obtener. El valor predeterminado es la fecha actual.	No
filtro	cuerda / cadena	Una o varias instrucciones que filtran las filas de la respuesta. Cada declaración contiene un nombre de campo del cuerpo de respuesta y un valor que están asociados a los operadores eq o ne. Además, las declaraciones se pueden combinar usando y o o. Los valores de cadena deben estar delimitados por comillas simples en el parámetro del filtro . Por ejemplo: filter=dataType eq 'acquisition'. Puede especificar los siguientes campos de filtro: adquisición salud de uso	Sí

Ejemplo de solicitud

En el ejemplo siguiente se muestra una solicitud para obtener datos de información. Sustituya el valor de applicationId por el identificador de tienda para su 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 respuesta

Importancia	Tipo	Descripción
Importancia	arreglo	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 a continuación la sección Valores de Insight.
Conteo Total	Int	Número total de filas en el resultado de los datos de la consulta.

Valores de información

Los elementos de la matriz Value contienen los valores siguientes.

Importancia	Tipo	Descripción
applicationId	cuerda / cadena	El ID de la tienda de la aplicación para la que estás recuperando datos de análisis.
Fecha de conocimiento	cuerda / cadena	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.
Tipo de dato	cuerda / cadena	Una de las siguientes cadenas que especifica el área de análisis general que describe esta información: adquisición salud de uso
detalle de conocimiento	arreglo	Uno o más valores de InsightDetail que representan los detalles de la información actual.

Valores de InsightDetail

Importancia	Tipo	Descripción
FactName	cuerda / cadena	Uno de los siguientes valores indica la métrica que describe la información o dimensión actuales, basado en el valor de tipo de datos . Para salud, este valor siempre es HitCount. Para adquisición, este valor siempre es CantidadDeAdquisición. Para uso, este valor puede ser una de las siguientes cadenas: UsuariosActivosDiarios DuraciónDelCompromisoMinutos DispositivosActivosDiarios UsuariosNuevosDiarios ConteoDiarioDeSesiones
SubDimensiones	arreglo	Uno o varios objetos que describen una única métrica para el conocimiento.
CambioPorcentual	cuerda / cadena	El porcentaje en que cambió la métrica en toda la base de clientes.
NombreDeDimensión	cuerda / cadena	Nombre de la métrica descrita en la dimensión actual. Entre los ejemplos se incluyen EventType, Market, DeviceType, PackageVersion, AcquisitionType, AgeGroup y Gender.
DimensionValue	cuerda / cadena	Valor de la métrica que se describe en la dimensión actual. Por ejemplo, si DimensionName es EventType, DimensionValue podría ser bloqueo o cuelgue.
FactValue	cuerda / cadena	Valor absoluto de la métrica en la fecha en que se detectó la información.
Dirección	cuerda / cadena	Dirección del cambio (positivo o negativo).
Fecha	cuerda / cadena	Fecha en la que identificamos el cambio relacionado con la perspectiva actual o la dimensión actual.

Nota:

Los cambios de Insights recuperados serán solo para los últimos 30 días de adquisiciones, salud o datos de uso.

Ejemplo de solicitud y respuesta

En los fragmentos de código siguientes se muestran algunos ejemplos de solicitud y cuerpo de respuesta JSON para esa solicitud.

Solicitud de ejemplo

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
}

Compartir a través de