Partager via

Obtenir les données d’insights pour votre application de bureau

  • Article

Utilisez cette méthode dans l’API d’analytique du Microsoft Store pour obtenir des données d’insights relatives aux métriques d’intégrité d’une application de bureau que vous avez ajoutée au programme Application de bureau Windows. Ces données sont également disponibles dans le rapport d’intégrité pour les applications de bureau dans l’Espace partenaires.

Prérequis

Pour utiliser cette méthode, vous devez d’abord effectuer les opérations suivantes :

  • Si ce n’est pas déjà fait, remplissez toutes les conditions préalables relatives à l’API d’analyse de la Boutique Microsoft.
  • Obtenir un jeton d’accès Azure AD à utiliser dans l’en-tête de requête pour cette méthode. Une fois que vous avez récupéré le jeton d’accès, vous avez 60 minutes pour l’utiliser avant qu’il n’expire. Une fois le jeton expiré, vous pouvez en obtenir un nouveau.

Requête

Syntaxe de la requête

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

En-tête de requête

En-tête Type Description
Autorisation string Obligatoire. Jeton d’accès Azure AD au format porteur<jeton>.

Paramètres de la demande

Paramètre Type Description Obligatoire
applicationId string ID de produit de l’application de bureau pour laquelle vous souhaitez obtenir des données d’insights. Pour obtenir l’ID produit d’une application de bureau, ouvrez un rapport d’analyse pour votre application bureautique dans l’Espace partenaires (tel que le rapport d’intégrité) et récupérez l’ID produit à partir de l’URL. Si vous ne spécifiez pas ce paramètre, le corps de la réponse contient des données d’insights pour toutes les applications inscrites dans votre compte. Non
startDate date Date de début dans la plage de dates des données d’insights à récupérer. La valeur par défaut est de 30 jours avant la date actuelle. Non
endDate date Date de fin dans la plage de dates des données d’insights à récupérer. La valeur par défaut est la date actuelle. Non
filter string Une ou plusieurs instructions qui filtrent les lignes dans la réponse. Chaque instruction contient un nom de champ à partir du corps de la réponse et une valeur associés aux opérateurs eq ou ne, et les instructions peuvent être combinées à l’aide et ou ou. Les valeurs de chaîne doivent être entourées de guillemets simples dans le paramètre de filtre. Par exemple, filter=dataType eq 'acquisition'.

Actuellement, cette méthode prend uniquement en charge l’intégrité du filtre.

 Non

Exemple de requête

L’exemple suivant illustre une demande d’obtention de données Insights. Remplacez la valeur applicationId par la valeur appropriée pour votre application de bureau.

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

Valeur Type Description
active tableau Tableau d’objets qui contiennent des données d’insights pour l’application. Pour plus d’informations sur les données de chaque objet, consultez la section Valeurs Insight ci-dessous.
TotalCount int Nombre total de lignes dans le résultat des données de la requête.

Valeurs d’insight

Les éléments du tableau Valeur contiennent les valeurs suivantes.

Valeur Type Description
applicationId string ID de produit de l’application de bureau pour laquelle vous avez récupéré des données Insights.
insightDate string Date à laquelle nous avons identifié le changement dans une métrique spécifique. Cette date représente la fin de la semaine dans laquelle nous avons détecté une augmentation ou une diminution significative d’une métrique par rapport à la semaine précédente.
dataType string Chaîne qui spécifie la zone d’analytique générale que cet insight informe. Actuellement, cette méthode prend uniquement en charge l’intégrité.
insightDetail tableau Une ou plusieurs valeurs InsightDetail qui représentent les détails de l’insight actuel.

Valeurs InsightDetail

Valeur Type Description
FactName string Chaîne qui indique la métrique décrite par l’insight actuel ou la dimension actuelle. Actuellement, cette méthode prend uniquement en charge la valeur HitCount.
Sous-dimensions tableau Un ou plusieurs objets qui décrivent une métrique unique pour l’insight.
PercentChange string Pourcentage que la métrique a changé dans l’ensemble de votre base de clients.
DimensionName string Nom de la métrique décrite dans la dimension actuelle. Les exemples incluent EventType, Market, DeviceType et PackageVersion.
DimensionValue string Valeur de la métrique décrite dans la dimension actuelle. Par exemple, si DimensionName est EventType, DimensionValue peut se bloquer ou se bloquer.
FactValue string Valeur absolue de la métrique à la date de détection de l’insight.
Sens string Direction du changement (positif ou négatif).
Date string Date à laquelle nous avons identifié la modification liée à l’insight actuel ou à la dimension actuelle.

Exemple de réponse

L’exemple suivant illustre un exemple de corps de réponse JSON pour cette requête.

{
  "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
}