Activer les achats de produits dans l’application (HTML)

Article
12/11/2015

[ Cet article est destiné aux développeurs de Windows 8.x et Windows Phone 8.x qui créent des applications Windows Runtime. Si vous développez une application pour Windows 10, voir la Documentation ]

Votre application peut offrir des produits et des fonctionnalités que vos clients peuvent acheter à partir de l’application. Nous allons vous montrer comment activer ces offres dans votre application.

Notez qu’un client ne peut acheter un produit dans l’application que s’il a acheté la version complète de cette dernière.

Ce que vous devez savoir

Technologies

Windows Runtime
Windows.ApplicationModel.Store

Prérequis

Application Windows Runtime dans laquelle ajouter des fonctionnalités que les clients peuvent acheter.

Instructions

Étape 1: Initialisation des informations de licence de votre application

Lors de l’initialisation de votre application, obtenez l’objet LicenseInformation de votre application en initialisant l’élément CurrentApp ou CurrentAppSimulator pour activer les achats d’un produit dans l’application.

function appInit()
{
    // some app initialization functions

        // Get current product object 
        // Execute only one of these statements. 
        // The next line is commented out for testing.
        // currentApp = Windows.ApplicationModel.Store.CurrentApp;

        // The next line is commented out for production/release.
        currentApp = Windows.ApplicationModel.Store.CurrentAppSimulator;

        // We should have either a real or a simulated CurrentProduct object here.

        // Get the license info
        licenseInformation = currentApp.licenseInformation;

    // other app initializations function
}

Remarque Lorsque vous codez et testez de nouveaux produits dans l’application pour la première fois, vous devez utiliser l’objet CurrentAppSimulator au lieu de l’objet CurrentApp. Cela vous permet de vérifier votre logique de licence à l’aide d’appels simulés destinés au serveur de licences au lieu d’appels destinés au serveur Windows Live. Pour cela, vous devez personnaliser le fichier nommé « WindowsStoreProxy.xml » dans %userprofile%\AppData\local\packages\<package name>\LocalState\Microsoft\Windows Store\ApiData. Le simulateur Microsoft Visual Studio crée ce fichier quand vous exécutez votre application pour la première fois. Vous pouvez également charger un fichier personnalisé au moment de l’exécution. Pour plus d’informations, voir la documentation relative à CurrentAppSimulator.

Étape 2: Ajout d’offres de produits dans l’application à votre application

Pour chaque fonctionnalité que vous voulez rendre disponible par le biais d’un produit dans l’application, créez une offre et ajoutez-la à votre application.

Important Vous devez ajouter dans l’application tous les produits que vous voulez présenter à vos clients avant d’envoyer cette dernière au Windows Store. Pour ajouter ultérieurement de nouveaux produits dans l’application, vous devez mettre à jour votre application et soumettre à nouveau une nouvelle version.

Création d’un jeton d’offre dans l’application

Identifiez chaque produit dans l’application, via un jeton. Ce jeton est une chaîne que vous définissez et utilisez dans votre application, ainsi que dans le Windows Store, pour identifier un produit spécifique dans l’application. Donnez à votre jeton un nom unique et évocateur (dans l’application) afin de pouvoir rapidement identifier la fonctionnalité qu’il représente, lors de l’écriture du code. Voici quelques exemples de noms :
- « SpaceMissionLevel4 »
- « ContosoCloudSave »
- « RainbowThemePack »
Codage de la fonctionnalité dans un bloc conditionnel

Vous devez placer dans un bloc conditionnel le code de chaque fonctionnalité associée à un produit dans l’application. Ce bloc vérifie si le client possède une licence lui permettant d’utiliser cette fonctionnalité.

Voici un exemple indiquant comment vous pouvez coder une fonctionnalité de produit nommée featureName dans le bloc conditionnel spécifique d’une licence. La chaîne featureName correspond au jeton qui identifie ce produit de manière unique au sein de l’application et qui permet de l’identifier dans le Windows Store.
```
if (licenseInformation.productLicenses.lookup("featureName").isActive) 
{
    // the customer can access this feature
}
else 
{
    // the customer can't access this feature
}
```
Ajout de l’interface utilisateur d’achat de cette fonctionnalité

Votre application doit également fournir à vos clients un moyen d’acheter le composant ou la fonctionnalité proposés par le produit dans l’application. En effet, ils ne peuvent pas les acheter par l’intermédiaire du Windows Store, de la même façon qu’ils ont acheté l’application complète.

Voici comment vérifier si votre client possède déjà un produit dans l’application et, si tel n’est pas le cas, comment afficher la boîte de dialogue d’achat lui permettant de l’acheter. Remplacez le commentaire « Afficher la boîte de dialogue d’achat » par votre code personnalisé pour la boîte de dialogue d’achat (par exemple, une page présentant un bouton « Acheter cette application » convivial).
```
function buyFeature1() {
    if (!licenseInformation.productLicenses.lookup("featureName").isActive)
    {
        // The customer doesn't own this feature, so 
        // show the purchase dialog.

        // note: currentApp is a reference to CurrentAppSimulator from a previous declaration
        currentApp.requestProductPurchaseAsync("featureName", false).then(
            function () {
                //Check the license state to determine if the in-app purchase was successful.
            }, 
            function () {
                // The in-app purchase was not completed because 
                // there was an error.
            });
    } 
    else
    {
        // The customer already owns this feature.
    }
}
```

Étape 3: Modification du code de test jusqu’aux appels finaux

C’est simple : remplacez chaque référence à CurrentAppSimulator par une référence à CurrentApp dans le code de votre application. Vous ne devez plus fournir le fichier WindowsStoreProxy.xml et vous pouvez par conséquent le supprimer du chemin d’accès de votre application (vous pourrez toutefois l’enregistrer pour référence lors de la configuration de l’offre dans l’application au cours de l’étape suivante).

Étape 4: Configuration dans le Windows Store de l’offre de produit dans l’application

Avant d’envoyer votre application au Windows Store, ajoutez chaque produit dans l’application au workflow Soumettre une application. C’est dans ce workflow que vous indiquez le jeton, le prix et la durée de vie des fonctionnalités d’un produit dans l’application. Veillez à effectuer les différents réglages en respectant la configuration définie dans le fichier WindowsStoreProxy.xml pendant le test.

Étape 5: Description dans le Windows Store du produit dans l’application

Après le téléchargement du package de votre application vers le Windows Store, vous pouvez saisir la description de chaque produit dans l’application, à la page Description, lors de la soumission de votre application. Si votre application prend en charge plusieurs langues, vous devez décrire chaque produit dans l’application et ce, dans chacune des langues prises en charge.

Décrivez de manière claire et précise ce que la fonctionnalité du produit dans l’application apporte à l’application. Si vous n’expliquez pas correctement la valeur ajoutée du produit indiqué ci-dessus par rapport à l’application elle-même, vous aurez des difficultés à le vendre. Pour en savoir plus sur des parties spécifiques de la description d’un produit dans l’application, voir Description de votre application.

Remarques

Si vous envisagez de fournir à vos clients des options de produits consommables dans l’application, passez à la rubrique Activer l’achat de produits consommables dans l’application.

Si vous avez besoin des reçus pour vérifier que l’utilisateur a bien acheté un produit dans l’application, consultez la section Utilisation de reçus pour vérifier les achats.

Rubriques associées

Activer l’achat de produits consommables dans l’application

Exemple d’application en version d’évaluation et d’achats dans l’application