Objets virtuels

Comment ça marche

Les objets virtuels sont des objets en jeu que les utilisateurs peuvent acheter contre des devises réelles ou de la monnaie virtuelle, ou encore recevoir en bonus. Ils sont dépourvus de forme physique et sont uniquement utilisés dans le jeu. Exemples courants : skins, potions, armes et autres éléments qui influencent le gameplay ou l’apparence des personnages.

Fonctionnalités principales :

• Configuration flexible des prix :
  • Définition du prix d’un objet unique en devise réelle et/ou en monnaie virtuelle ;
  • Création d’objets gratuits.
• Détection automatique du pays et de la devise de l’utilisateur.
• Configuration de la disponibilité :
  • Restriction de la vente d’objets dans une région spécifique ;
  • Limitation du nombre d’objets disponibles à l’achat ;
  • Limitation de la durée d’affichage des objets dans le magasin ;
  • Configuration d’objets non disponibles à l’achat. Un objet peut être masqué dans le catalogue tout en restant disponible dans un lot ou comme bonus lors de l’achat d’un autre objet.

Comment configurer

Configuration dans 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 item dans la liste déroulante.

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

5. Définissez les prix ou créez un objet gratuit dans le champ Paid or free :

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

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

6. Pour limiter le nombre d’objets qu’un utilisateur peut acheter, activez la bascule Limit number of times one user can buy this item et entrez la quantité souhaitée.
7. 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 de l’objet ;
      • No regular refresh.

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

8. Configurez une limite de temps pour l’affichage de l’objet (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.

9. 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.

10. Vérifiez les paramètres et appuyez sur Create item.

Configuration via API

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

Affichage des objets virtuels dans le magasin

L’affichage des objets virtuels 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

Pour afficher un objet virtuel sur le site web :

1. Créez un objet virtuel.

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 du bloc Store, sélectionnez Virtual items dans le champ Item type et sélectionnez le groupe d’objets que vous souhaitez vendre sur le site web dans le champ Item group.

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 un groupe d’objets virtuels sera disponible. Si aucun objet 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 les objets virtuels via API

Pour récupérer le catalogue d’objets virtuels côté client, utilisez les méthodes de la sous-section Catalogue du groupe de méthodes Objets et monnaie virtuels. Aucune autorisation n’est requise pour les utiliser.

Attribuez des objets virtuels aux utilisateurs

Selon le type d’objet et les paramètres d’intégration, un objet virtuel est attribué à 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.

Liens utiles