Monnaie virtuelle

Comment ça marche

La monnaie virtuelle est une devise numérique utilisée pour acheter et vendre des objets virtuels. Selon son usage, elle peut influer sur l’équilibre économique du jeu ou être liée à la monétisation des applications.

Fonctionnalités principales :

• Vente de monnaie virtuelle en quantité libre ou sous forme de packages à montant fixe.
• Vente de monnaie virtuelle et de packages de monnaie virtuelle contre des devises réelles ou des monnaies virtuelles.
• Limiter le nombre de packages de monnaie virtuelle disponibles à l’achat.
• Limiter la durée d’affichage de la monnaie virtuelle et des packages de monnaie virtuelle dans le magasin.
• Packages de monnaie virtuelle gratuits.

Les options suivantes sont disponibles pour vendre de la monnaie virtuelle :

• Tout montant : permet de vendre de la monnaie virtuelle pour le montant spécifié par l’utilisateur. Pour utiliser cette option, implémentez côté client un champ de saisie permettant à l’utilisateur d’entrer le montant souhaité lors de l’achat.
• Packages : permet de vendre de la monnaie virtuelle en montants prédéfinis. Le prix d’un package de monnaie est défini séparément et peut différer du prix standard du même montant de cette monnaie.

1. Exemple : un package contient 100 pièces d’or et coûte 90 $, tandis que le prix d’une pièce d’or est de 1 $.

Restrictions :

• Vous ne pouvez ajouter qu’un seul type de monnaie virtuelle à un package.
• Vous pouvez configurer un prix dans une autre monnaie virtuelle uniquement via des appels API.
• Vous pouvez rendre un package de monnaie virtuelle gratuit, sans fixer de prix en devise réelle ni en monnaie virtuelle, en le configurant via le Compte éditeur ou via des appels API. Vous pouvez créer de la monnaie virtuelle gratuite en dehors d’un package uniquement via des appels API.
• Vous ne pouvez spécifier le montant de monnaie virtuelle dans un package que sous forme d’un nombre entier.

Comment configurer

Configuration dans le Compte éditeur

• Monnaie virtuelle
• Packages de monnaie virtuelle

Pour configurer une monnaie virtuelle via le Compte éditeur :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > All items.
2. Appuyez sur Add et sélectionnez Virtual currency dans la liste déroulante.

3. Spécifiez les paramètres suivants :
   1. Image (facultatif) ;
   2. UGS ;
   3. Nom de la monnaie virtuelle.
4. Pour configurer l’affichage de la monnaie virtuelle dans le magasin, sélectionnez le statut approprié.

5. Pour définir un prix, appuyez sur Set up prices et indiquez le prix en devise réelle. Si nécessaire, configurez les prix régionaux.
6. Configurez les attributs en utilisant l’une des méthodes suivantes (facultatif) :

1. 1. Ajoutez des attributs et leurs valeurs au format JSON.

1. 2. Créez manuellement des attributs et des valeurs et associez-les à des objets spécifiques.

7. Vérifiez les paramètres et appuyez sur Create currency.

Note

Avant de configurer un package de monnaie virtuelle, créez d’abord une monnaie virtuelle.

Pour configurer un package de monnaie virtuelle via le Compte éditeur :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > All items.
2. Appuyez sur Add et sélectionnez Virtual currency package dans la liste déroulante.

3. Spécifiez les paramètres suivants :
   1. Image (facultatif) ;
   2. UGS ;
   3. Un ou plusieurs groupes auxquels le package doit appartenir ;
   4. Nom ;
   5. Description (facultatif).
4. Pour configurer l’affichage de la monnaie virtuelle dans le magasin, sélectionnez le statut approprié.

5. Spécifiez la monnaie virtuelle incluse dans le package ainsi que sa quantité.
6. Définissez les prix ou créez un objet gratuit dans le champ Paid or free :

1. • Pour créer un package gratuit, sélectionnez Free package.

1. • Pour définir un prix, sélectionnez Paid package et indiquez le prix en devise réelle. Si nécessaire, configurez les prix régionaux.

7. Pour limiter le nombre de packages qu’un utilisateur peut acheter, activez la bascule Limit number of times one user can buy package et entrez la quantité souhaitée.
8. Pour configurer la fréquence de réinitialisation de la limite :

1. 1. Dans la liste déroulante, sélectionnez une période :
      • Daily ;
      • Weekly ;
      • Monthly ;
      • Custom interval – l’intervalle est calculé à partir de la date de début d’affichage du package ;
      • No regular refresh.

1. 2. Configurez le calendrier de réinitialisation en fonction de la période sélectionnée.

9. Configurez une limite de temps pour l’affichage du package (facultatif) :

1. 1. Dans le champ Show item in store, sélectionnez Limited time.

1. 2. Précisez le fuseau horaire ainsi que le début et la fin de la période.

1. 1. Si vous ne souhaitez pas définir de date de fin pour l’affichage de l’objet, cochez la case No end date.

10. Configurez les attributs en utilisant l’une des méthodes suivantes (facultatif) :

1. 1. Ajoutez des attributs et leurs valeurs au format JSON.

1. 2. Créez manuellement des attributs et des valeurs et associez-les à des objets spécifiques.

11. Vérifiez les paramètres et appuyez sur Create package.

Configuration via API

Pour configurer des monnaies virtuelles, utilisez les appels de la sous-section Administrateur du groupe Objets et monnaie virtuels.

Affichage de la monnaie virtuelle dans le magasin

L’affichage de la monnaie virtuelle ou des packages de monnaie virtuelle dépend de la manière dont le catalogue est implémenté, via le constructeur de site ou via API.

Affichage via le constructeur de site

1. Créez un package de monnaie virtuelle.
2. Ouvrez le projet dans le Compte éditeur et accédez à la section Storefronts > Websites.
3. Dans le volet du site souhaité, appuyez sur Open Site Builder.

4. Dans la section Store, sélectionnez dans le champ Item type le package de monnaie virtuelle que vous souhaitez vendre sur le site web.

5. Définissez une disposition de carte d’objet.
6. Après avoir effectué toutes les modifications nécessaires et préparé le site web pour le lancement :
   1. Dans le coin supérieur droit du constructeur, appuyez sur Publish ;
   2. Sélectionnez les pages que vous souhaitez publier en cochant les cases correspondantes ;
   3. Appuyez sur Publish.

Une fois le site publié, une section contenant les packages de monnaie virtuelle sera disponible. Si aucun package n’apparaît, vérifiez que leur statut est défini sur Available et qu’aucune limite d’affichage basée sur le temps n’est active.

Récupérez des informations sur la monnaie virtuelle via API

Pour récupérer le catalogue des monnaies virtuelles et des packages de monnaie virtuelle côté client, utilisez les appels de la sous-section Catalogue du groupe Objets et monnaie virtuels.

Attribuez de la monnaie virtuelle aux utilisateurs

Selon le type d’objet et les paramètres d’intégration, une monnaie virtuelle est attribuée à l’utilisateur de l’une des manières suivantes :

• Si vous avez intégré PlayFab, la monnaie virtuelle et les objets virtuels sont automatiquement ajoutés à l’inventaire PlayFab de l’utilisateur.
• Si vous utilisez un système d’attribution personnalisé, la monnaie virtuelle et les objets virtuels sont attribués de votre côté. Nous recommandons de configurer un gestionnaire de webhook pour recevoir les données de commande sur votre backend. Les informations nécessaires sont incluses dans le webhook Paiement de commande réussi.