Obtenir des acquisitions d’extensions

Utilisez cette méthode dans l’API d’analyse de la Boutique Microsoft pour obtenir des données d’acquisition agrégées pour les modules complémentaires pour votre application au format JSON pendant une plage de dates donnée et d’autres filtres facultatifs. Ces informations sont également disponibles dans le rapport sur les acquisitions de modules complémentaires 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

En-tête de requête

Paramètres de la demande

Le paramètre applicationId ou inAppProductId est requis. Pour récupérer les données d’acquisition pour tous les modules complémentaires inscrits à l’application, spécifiez le paramètre applicationId. Pour récupérer les données d’acquisition d’un module complémentaire unique, spécifiez le paramètre inAppProductId. Si vous spécifiez les deux, le paramètre applicationId est ignoré.

Champs Filtrer

Le paramètre de filtre 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 et ou ou. Voici quelques exemples de paramètres de filtre :

• filter=market eq 'US' and gender eq 'm'
• filter=(market ne 'US') et (gender ne 'Unknown') et (gender ne 'm') et (market ne 'NO') et (ageGroup ne 'supérieur à 55' ou ageGroup ne 'inférieur à 13')

Pour connaître les champs pris en charge, consultez la table suivante. Les valeurs de chaîne doivent être entourées de guillemets simples dans le paramètre de filtre.

Exemple de requête

Les exemples suivants illustrent plusieurs demandes d’obtention de données d’acquisition de modules complémentaires. Remplacez les valeurs inAppProductId et applicationId par l’ID Store approprié pour votre module complémentaire ou votre application.

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappacquisitions?inAppProductId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=2/1/2015&top=10&skip=0 HTTP/1.1
Authorization: Bearer <your access token>

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

GET https://manage.devcenter.microsoft.com/v1.0/my/analytics/inappacquisitions?inAppProductId=9NBLGGGZ5QDR&startDate=1/1/2015&endDate=7/3/2015&top=100&skip=0&filter=market ne 'US' and gender ne 'Unknown' and gender ne 'm' and market ne 'NO' and ageGroup ne '>55' HTTP/1.1
Authorization: Bearer <your access token>

Response

Response body

Valeurs d’acquisition de modules complémentaires

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

Exemple de requête et de réponse

L’extrait de code suivant illustre 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/inappacquisitions?applicationId=9NBLGGGZ5QDR
HTTP/1.1
Authorization: Bearer <your access token>

Exemple de réponse

{
    "Value": [
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Deluxe Collector's Edition",
            "addonProductId": "9NBLGGAAGZDQ",
            "date": "2022-07-29",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 18.12,
            "purchasePriceLocalAmount": 18.12,
            "purchaseTaxUSDAmount": 1.13,
            "purchaseTaxLocalAmount": 1.13
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Episode 4",
            "addonProductId": "9NAAAAAAAAAQ",
            "date": "2017-01-07",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 4.147206,
            "purchasePriceLocalAmount": 3.99,
            "purchaseTaxUSDAmount": 0.686004,
            "purchaseTaxLocalAmount": 0.66
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Deluxe Collector's Edition",
            "addonProductId": "9NALGGGZ5QDQ",
            "date": "2018-04-01",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 1.99,
            "purchasePriceLocalAmount": 1.99,
            "purchaseTaxUSDAmount": 0.0,
            "purchaseTaxLocalAmount": 0.0
        },
        {
            "applicationId": "9NBLGGGZ5QDR",
            "inAppProductName": "Strategy Guide Episode 4",
            "addonProductId": "9NBLGGGZ5QDQ",
            "date": "2021-11-25",
            "acquisitionQuantity": 1,
            "purchasePriceUSDAmount": 1.31902922876179,
            "purchasePriceLocalAmount": 150.0,
            "purchaseTaxUSDAmount": 0.114315866492689,
            "purchaseTaxLocalAmount": 13.0
        },
    ],
    "TotalCount": 4,
    "DataFreshnessTimestamp": "2022-07-29T05:54:00"
}

Rubriques connexes

• Rapport sur les acquisitions des extensions
• Accéder aux données d’analyse à l’aide des services de la Boutique Microsoft
• Obtenir les conversions d’extensions par canal
• Obtenir des acquisitions d’applications
• Obtenir les données d’entonnoir d’acquisition d’applications
• Obtenir les conversions d’applications par canal