Activer les achats dans l’application à partir de votre application (HTML)

Applies to Windows and Windows Phone

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.

Si vous souhaitez essayer de travailler avec des achats intégrés et d’autres fonctionnalités principales de Windows 8, vous pouvez télécharger les ateliers pratiques pour Windows 8. Ces laboratoires constituent une introduction modulaire pas à pas à la création d’un exemple d’application du Windows Store dans le langage de programmation de votre choix (JavaScript et HTML ou C# et XAML).

Pour savoir comment se présente cette expérience pour le client, voirExpérience d’achat dans l’application pour un client. Notez qu’un client ne peut faire un achat dans l’application que s’il a acheté une version complète de celle-ci.

Ce que vous devez savoir

Technologies

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, recherchez l’objet LicenseInformation de votre application en initialisant CurrentApp ou CurrentAppSimulator pour activer les achats 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  Quand vous codez et testez de nouvelles offres 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 au serveur de licences au lieu d’appels au serveur Windows Live. Pour cela, vous devez personnaliser le fichier nommé « WindowsStoreProxy.xml » dans <installation_folder>\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 des offres intégrées à l’application à votre application

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

Important  Vous devez ajouter toutes les offres dans l’application que vous voulez présenter à vos clients avant de l’envoyer au Store. Pour ajouter des offres dans l’application ultérieurement, vous devrez mettre à jour votre application et soumettre à nouveau une nouvelle version.

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

    Identifiez chaque offre dans l’application par un jeton d’offre dans l’application. Ce jeton est une chaîne que vous définissez et utilisez dans votre application et dans le Store pour identifier une offre dans l’application spécifique. Donnez à votre offre un nom unique et évocateur afin que vous puissiez identifier rapidement la fonctionnalité qu’elle représente lors de l’écriture du code. Voici quelques exemples de noms :

    • « SpaceMissionLevel4 »
    • « ContosoCloudSave »
    • « RainbowThemePack »
  2. Codage de la fonctionnalité dans un bloc conditionnel

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

    Voici un exemple indiquant comment vous pouvez coder une fonctionnalité nommée featureName dans le bloc conditionnel spécifique d’une licence. La chaîne featureName est le jeton qui identifie de manière unique cette fonctionnalité au sein de l’application et qui est également utilisé pour l’identifier dans le Store.

    
    
    if (licenseInformation.productLicenses.lookup("featureName").isActive) 
    {
        // the customer can access this feature
    }
    else 
    {
        // the customer can't access this feature
    }
    
    
    
  3. Ajout de l’interface utilisateur d’achat de cette fonctionnalité

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

    Voici comment tester si votre client possède déjà une offre dans l’application et, si ce n’est pas le cas, comment afficher la boîte de dialogue d’achat lui permettant de le faire. Remplacez le commentaire « afficher la boîte de dialogue d’achat » par votre code personnalisé pour cette boîte de dialogue d’achat (par exemple une page avec un bouton « Achetez cette application ! »).

    
    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 de l’offre dans l’application dans le Store

Avant d’envoyer votre application au Store, ajoutez chaque offre dans l’application au workflow Soumettre une application. C’est l’endroit où vous spécifiez le jeton d’offre, le prix et la durée de vie de l’offre dans l’application. Veillez à la configurer exactement comme la configuration que vous avez définie dans WindowsStoreProxy.xml pendant le test.

Étape 5: Description de l’offre dans l’application dans le Store

Après le téléchargement du package de votre application vers le Store, vous pouvez entrer la description de chaque offre 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 offre dans l’application dans chacune des langues prises en charge.

Fournissez une description claire et précise qui indique ce que la fonctionnalité apporte à l’application. Si vous n’expliquez pas correctement en quoi la fonctionnalité est utile, vous aurez du mal à la vendre. Pour plus d’informations sur des parties spécifiques de la description d’un achat dans l’application, voir Description de votre application.

Remarques

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

Si vous avez besoin des reçus pour vérifier que l’utilisateur a fait un achat dans l’application, consultez la section Vérification des achats à l’aide des reçus.

Rubriques associées

Activer l’achat dans l’application de consommables
Exemple d’application en version d’évaluation et d’achats dans l’application

 

 

Afficher:
© 2014 Microsoft