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 de la tarification:
  • Définir un prix pour un objet unique en devise réelle et/ou en monnaie virtuelle.
  • Créer des 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.
  • Limiter le nombre d’objets disponibles à l’achat.
  • Limiter la durée d’affichage des objets dans le magasin.
  • Configurer des objets non disponibles à l’achat. Un objet peut être masqué du catalogue tout en restant disponible dans un lot ou comme bonus pour un autre objet.

Comment configurer

2. Appuyez sur Create manually, puis sélectionnez Virtual item dans la liste déroulante.

3. Dans la section General settings, indiquez les éléments suivants :
   • UGS
   • un ou plusieurs groupes auxquels l’objet doit appartenir (facultatif)
   • nom
   • description courte
   • description détaillée : pour l’ajouter, activez la bascule correspondante (facultatif)

4. Dans la sectionMedia, importez une ou plusieurs images ou vidéos depuis votre appareil ou via un lien (facultatif). Dans le magasin créé avec l’éditeur de site Xsolla, toutes les fiches d’objet affichent le fichier marqué Main. Les autres fichiers sont uniquement disponibles dans les fiches dotées d’une galerie de médias. Le fichier marqué Main est également renvoyé dans les réponses des appels API de récupération du catalogue.

5. Dans la section Price settings, définissez les prix ou créez un objet gratuit :
   • Pour définir un prix, sélectionnez Paid item, activez les bascules Pricing in real currency et/ou Pricing in virtual currency, puis indiquez le prix. Si nécessaire, configurez les prix régionaux.
   • Pour créer un objet gratuit, sélectionnez Free item.

6. Pour limiter le nombre d’objets disponibles à l’achat :
   1. Activez la bascule dans la section Limits et indiquez la quantité.
   2. Configurez la fréquence de réinitialisation de la limite. Pour cela, sélectionnez une période dans la liste déroulante :
      1. Daily.
      2. Weekly.
      3. Monthly.
      4. Custom interval. L’intervalle est calculé à partir de la date de début daffichage de l’objet dans le magasin.
      5. No regular refresh.
   3. Définissez le calendrier de réinitialisation en renseignant les paramètres de la période sélectionnée.

7. Pour limiter la période d’affichage de l’objet (facultatif) :

   1. Activez la bascule dans la section Add specific display period.
   2. Indiquez le fuseau horaire ainsi que le début et la fin de la période.

   Pour ne pas définir de date de fin, activez la bascule No end date.

8. Configurez les attributs à l’aide de l’une des options suivantes (facultatif) :
   1. Ajouter des attributs et leurs valeurs au format JSON.
   2. Créer manuellement des attributs et leurs valeurs et les lier aux objets.

9. Si l’objet payant est utilisé dans un mécanisme de récompenses aléatoires, comme les loot boxes ou le gacha, activez la bascule Mark as paid randomized reward.

10. Appuyez sur Create.

11. Dans la fenêtre qui s’ouvre, sélectionnez le statut de l’objet et appuyez sur Continue.

L’objet créé apparaît dans la section All items.

Configurer via l’API

Pour configurer des objets virtuels, vous pouvez utiliser les appels de la sous-section Admin dans le groupe Objets virtuels et monnaie virtuelle.

Afficher 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 l’API.

Afficher via l’éditeur de site

Pour afficher un objet virtuel sur le site web :

1. Créer un objet virtuel.

2. Dans votre projet dans le Compte éditeur, accédez à la section Storefronts > Websites.

3. Dans le volet du site souhaité, cliquez sur Open Site Builder.

2. Dans votre projet dans le compte pour les jeux mobiles, accédez à la section Web Shop.

3. Cliquez sur le volet du site souhaité.

4. Si votre site comprend plusieurs pages, sélectionnez celle qu’il vous faut :

   1. Cliquez sur le titre de la page actuelle en haut de l’éditeur.
   2. Sélectionnez la page nécessaire dans la liste déroulante.

5. Dans la section du bloc Store, sélectionnez Virtual items dans le champ Item type et sélectionnez dans le champ Item group le groupe d’objets que vous souhaitez vendre sur le site web.

6. Définissez une disposition de carte d’objet.

7. Après avoir effectué toutes les modifications nécessaires et préparé votre site web pour le lancement :

   1. Dans le coin supérieur droit de l’éditeur de site, cliquez sur Publish.
   2. Cochez les cases à côté des pages que vous souhaitez publier.
   3. Cliquez sur Publish.

Une fois le site publié, une section avec un groupe d’objets virtuels sera disponible. Si aucun objet n’est affiché, vérifiez que leur statut est défini sur Available et qu’aucune limite d’affichage basée sur le temps n’est active.

Obtenir des informations sur un objet virtuel via l’API

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

Attribuer 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 sont automatiquement ajoutés à l’inventaire PlayFab de l’utilisateur.
• Si vous utilisez un système de livraison personnalisé, toutes les monnaies et tous les objets virtuels sont accordés de votre côté. Nous vous recommandons de configurer un gestionnaire de webhook pour recevoir les données de commande sur votre backend. Les données nécessaires sont incluses dans le webhook Successful payment for order.

Pour plus de détails sur ce sujet et sur d’autres méthodes de récupération des données d’achat, consultez la section Configurer le suivi du statut de la commande.

Liens utiles