Compartir a través de

Obtén datos de análisis para tu aplicación de escritorio

Usa este método en la API de análisis de Microsoft Store para obtener información relacionada con las métricas de estado de una aplicación de escritorio que hayas agregado al programa aplicación de escritorio de windows. Estos datos también están disponibles en el informe de salud de para aplicaciones de escritorio en el Centro de Partners.

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/desktop/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 Identificador de producto de la aplicación de escritorio para la que desea obtener datos de información. Para obtener el identificador de producto de una aplicación de escritorio, abra cualquier informe de análisis de para la aplicación de escritorio en el Centro de Partners (como el informe de estado de ) y recupere el identificador de producto de la dirección URL. 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'.

Actualmente, este método solo admite el filtro de salud .

 No

Ejemplo de solicitud

En el ejemplo siguiente se muestra una solicitud para obtener datos de información. Reemplace el valor applicationId por el valor adecuado para la aplicación de escritorio.

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>

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 Identificador del producto de la aplicación de escritorio para la que ha recuperado los 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 Cadena que especifica el área de análisis general que informa esta información. Actualmente, este método solo admite de salud.
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 Cadena que indica la métrica que describe la información actual o la dimensión actual. Actualmente, este método solo admite el valor HitCount.
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, DeviceTypey PackageVersion.
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.

Ejemplo de respuesta

En el ejemplo siguiente se muestra un cuerpo de respuesta JSON de ejemplo para esta solicitud.

{
  "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
}
  • Last updated on