Obtener información detallada de la aplicación de escritorio

  • Artículo

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 has agregado al programa Aplicación de escritorio de Windows. Estos datos también están disponibles en el informe estado de las aplicaciones de escritorio en el Centro de partners.

Requisitos previos

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

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

Solicitud

Sintaxis de la solicitud

Método URI de solicitud
GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/desktop/insights

Encabezado de solicitud

Encabezado Tipo Descripción
Authorization 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 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 la aplicación de escritorio en el Centro de partners (como el informe de estado) 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 para 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 predeterminada es la actual. No
filter string Una o más instrucciones que filtran las filas de la respuesta. Cada instrucción contiene un nombre de campo del cuerpo y el valor de la respuesta asociados a los operadores eq o ne, y las instrucciones se pueden combinar mediante yo . Ten en cuenta que en el parámetro filter los valores de la cadena deben estar entre comillas simples. Por ejemplo, filter=dataType eq 'acquisition'.

Actualmente, este método solo admite el estado del filtro.

 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>

Response

Response body

Valor Tipo Descripción
Valor array Matriz de objetos que contienen datos de información de 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 El número total de filas del resultado de datos de la consulta.

Valores de información

Los elementos de la matriz Value contienen los siguientes valores.

Valor Tipo Descripción
applicationId string Identificador de producto de la aplicación de escritorio para la que recuperó los datos de información.
insightDate 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 a esa.
dataType string Cadena que especifica el área de análisis general que informa esta información. Actualmente, este método solo admite el estado.
insightDetail array Uno o varios valores insightDetail que representan los detalles de la información actual.

Valores de InsightDetail

Valor Tipo Descripción
FactName string 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 array Uno o varios objetos que describen una sola métrica para la información.
PercentChange cadena Porcentaje que cambió la métrica en toda la base de clientes.
DimensionName cadena Nombre de la métrica descrita en la dimensión actual. Entre los ejemplos se incluyen EventType, Market, DeviceType y PackageVersion.
DimensionValue cadena 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 cadena 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).
Fecha cadena Fecha en la que identificamos el cambio relacionado con la información actual o la dimensión actual.

Ejemplo de respuesta

En el ejemplo siguiente se muestra el cuerpo de una respuesta JSON de ejemplo realizada 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
}