Obtenir les données d’insights pour votre application de bureau
Utilisez cette méthode dans l’API d’analyse 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 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 vous ne l’avez pas déjà fait, remplissez toutes les conditions préalables pour l’API d’analyse du Microsoft Store.
- Obtenez un jeton d’accès Azure AD à utiliser dans l’en-tête de requête de 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 arrivé à expiration, 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 sous la formeJeton> du porteur<. |
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 de produit d’une application de bureau, ouvrez n’importe quel rapport d’analytique pour votre application de bureau dans l’Espace partenaires (par exemple, le rapport d’intégrité) et récupérez l’ID de produit à partir de l’URL. Si vous ne spécifiez pas ce paramètre, le corps de la réponse contiendra des données d’insights pour toutes les applications inscrites sur 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 de la réponse. Chaque instruction contient un nom de champ 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 de etou. Les valeurs de chaîne doivent être entourées par des guillemets dans le paramètre filter. 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 d’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 |
---|---|---|
Valeur | 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 d’insight ci-dessous. |
TotalCount | int | Nombre total de lignes dans les résultats de la requête. |
Valeurs d’insight
Les éléments du tableau Value comportent 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 d’insights. |
insightDate | string | Date à laquelle nous avons identifié la modification d’une métrique spécifique. Cette date représente la fin de la semaine au cours de 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’analyse générale que cette 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 des insights actuels. |
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 seule métrique pour l’insight. |
PercentChange | string | Pourcentage que la métrique a changé sur 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 à laquelle l’insight a été détecté. |
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 représente un 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
}
Rubriques connexes
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour