Partager via

Obtenir les données de l'entonnoir d'acquisition d'applications

Utilisez cette méthode dans l’API d’analyse du Microsoft Store pour obtenir des données d’entonnoir d’acquisition pour une application pendant une plage de dates donnée et d’autres filtres facultatifs. Ces informations sont également disponibles dans le rapport Acquisitions dans l’Espace partenaires.

Conditions préalables

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

  • Si vous ne l’avez pas déjà fait, remplissez tous les prérequis pour l’API d’analytique du Microsoft Store.
  • Obtenez 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 la requête
OBTENIR https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel

En-tête de requête

En-tête de page Catégorie Descriptif
Autorisation ficelle Obligatoire. Le jeton d’accès Azure AD sous la forme Bearer<token>.

Paramètres de la demande

Paramètre Catégorie Descriptif Obligatoire
applicationId ficelle L’ID Store de l’application pour laquelle vous souhaitez récupérer les données de l’entonnoir d’acquisition. Un exemple d’ID store est 9WZDNCRFJ3Q8. Oui
date de début date Date de début dans la plage de dates des données d’entonnoir d’acquisition à récupérer. La valeur par défaut est la date actuelle. Non
date de fin date Date de fin dans la plage de dates des données d’entonnoir d’acquisition à récupérer. La valeur par défaut est la date actuelle. Non
Filter ficelle Une ou plusieurs instructions qui filtrent les lignes dans la réponse. Pour plus d’informations, consultez la section des champs de filtre ci-dessous. Non

 

Champs de filtre

Le filtre paramètre de la requête contient une ou plusieurs instructions qui filtrent les lignes dans la réponse. Chaque instruction contient un champ et une valeur associés aux opérateurs eq ou ne , et les instructions peuvent être combinées à l’aide etou ou.

Les champs de filtre suivants sont pris en charge. Les valeurs de chaîne doivent être entourées de guillemets simples dans le paramètre de filtre .

Domaines Descriptif
identifiant de campagne Chaîne d’ID d’une campagne de promotion d’application personnalisée associée à l’acquisition.
marché Chaîne qui contient le code pays ISO 3166 du marché où l’acquisition s’est produite.
type de dispositif Une des chaînes suivantes qui spécifie le type d’appareil sur lequel l’acquisition s’est produite :
  • PC
  • Téléphone
  • Console-Xbox One
  • Console-Xbox Série X
  • IdO
  • Holographique
  • Inconnu
tranche d'âge Une des chaînes suivantes qui spécifie le groupe d’âge de l’utilisateur qui a terminé l’acquisition :
  • 0 à 17
  • 18 à 24
  • 25 à 34
  • 35 à 49
  • 50 ou plus
  • Inconnu
sexe Une des chaînes suivantes qui spécifie le sexe de l’utilisateur qui a terminé l’acquisition :
  • M
  • F
  • Inconnu

Exemple de requête

L'exemple suivant illustre plusieurs requêtes pour obtenir les données de l'entonnoir d'acquisition d'une application. Remplacez la valeur applicationId par l’ID store de votre application.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=1/1/2017&endDate=2/1/2017  HTTP/1.1
Authorization: Bearer <your access token>

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=8/1/2016&endDate=8/31/2016&filter=market eq 'US' and gender eq 'm'  HTTP/1.1
Authorization: Bearer <your access token>

Réponse

Corps de réponse

Valeur Catégorie Descriptif
Valeur tableau Tableau d’objets qui contiennent des données du parcours d'acquisition de l'application. Pour plus d’informations sur les données de chaque objet, consultez la section valeurs d’entonnoir ci-dessous.
NombreTotal Int Nombre total d’objets dans le tableau Valeur.

Valeurs d’entonnoir

Les objets du tableau Valeur contiennent les valeurs suivantes.

Valeur Catégorie Descriptif
Type de Mesure ficelle L’une des chaînes suivantes qui spécifie le type de données en entonnoir inclus dans cet objet :
  • VuePage
  • acquisition
  • installer
  • Utilisation
Nombre d'utilisateurs ficelle Nombre d’utilisateurs qui ont effectué l’étape d’entonnoir spécifiée par la valeur de type de métrique .

Exemple de demande et de réponse

Les extraits de code suivants illustrent un exemple de corps de requête et de réponse JSON pour cette requête.

Exemple de requête

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR
HTTP/1.1
Authorization: Bearer <your access token>

Exemple de réponse

{
    "Value": [
        {
            "MetricType": "PageView",
            "UserCount": 6214
        },
        {
            "MetricType": "Acquisition",
            "UserCount": 1502
        },
        {
            "MetricType": "Usage",
            "UserCount": 606
        },
        {
            "MetricType": "Install",
            "UserCount": 977
        }
    ],
    "TotalCount": 4
}

Exemple de requête

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/funnel?applicationId=9NBLGGGZ5QDR&startDate=12/19/2021&endDate=12/21/2021&filter=market eq 'US' and gender eq 'm'
HTTP/1.1
Authorization: Bearer <your access token>

Exemple de réponse

{
    "Value": [
        {
            "MetricType": "PageView",
            "UserCount": 10
        },
        {
            "MetricType": "Acquisition",
            "UserCount": 8
        },
        {
            "MetricType": "Usage",
            "UserCount": 5
        },
        {
            "MetricType": "Install",
            "UserCount": 3
        }
    ],
    "TotalCount": 4
}
  • Last updated on