Biens gratuits

Les biens gratuits sont un type de biens que les utilisateurs peuvent obtenir sans dépenser de la monnaie virtuelle ou de devises réelles. Il peut s’agir de :

• Objets virtuels ;
• Lots ;
• Packages de monnaie virtuelle.

Les biens gratuits ne sont disponibles que pour les utilisateurs autorisés. Les utilisateurs non autorisés peuvent uniquement consulter le catalogue des biens gratuits.

Exemples d’utilisation :

• Vous pouvez offrir des biens gratuits à des dates importantes pour votre projet (par exemple, le jour où le projet a été créé) afin de récompenser les utilisateurs pour leur fidélité.
• Vous pouvez distribuer des kits de démarrage gratuits pour le jeu dans le magasin afin d’attirer de nouveaux utilisateurs sur le jeu.

Vous pouvez limiter la distribution gratuite d’objets uniques si l’utilisateur les possède déjà.

Pour configurer des biens gratuits :

1. Ajouter des biens gratuits au catalogue.
2. Implémentez la logique de commande de biens gratuits par l’utilisateur.
3. Implémentez la logique d’octroi de biens gratuits à l’utilisateur.

Ajouter des biens gratuits au catalogue

Des instructions détaillées pour créer des biens sont disponibles dans les sections suivantes de la documentation :

• Configurer un package de monnaie virtuelle ;
• Créer des objets virtuels ;
• Créer des lots.

Lorsque vous créez ou modifiez un bien gratuit, assurez-vous de sélectionner Free item, Free package ou Free bundle dans la section Paid or Free.

Commande de biens gratuits par un utilisateur

L’utilisateur peut commander un bien gratuit de deux manières :

• En un clic (sans utiliser le panier) — un UGS dans n’importe quelle quantité. Par exemple, 100 potions identiques.
• Via le panier — tous les types de biens dans n’importe quelle quantité.

Commande d'un bien gratuit en un clic

Pour implémenter cette option, appelez la méthode SDK createOrderWithSpecifiedFreeItem lorsque l’utilisateur clique sur le bouton correspondant du catalogue pour commander un bien gratuit.

La livraison des biens à l’inventaire utilisateur côté Xsolla a lieu immédiatement après une requête réussie avec cette méthode (sans qu’il soit nécessaire d’ouvrir Pay Station).

Commande de biens gratuits via le panier

Dans le cas où l’utilisateur achète via le panier :

• Si le panier de l’utilisateur contient à la fois des biens payants et des biens gratuits :
  1. Obtenez le jeton de paiement et l’ID de commande à l’aide de la méthode SDK fetchCartPaymentToken ;
  2. Implémentez l’ouverture de l’interface de paiement. Pour ce faire, appelez la méthode SDK openPurchaseUI et passez-lui le jeton de paiement et l’ID de commande obtenus.

• Si le panier de l'utilisateur ne contient que des biens gratuits, appelez la méthode SDK createOrderWithFreeCart ou createOrderWithSpecifiedFreeItem. La livraison des biens à l'inventaire utilisateur côté Xsolla a lieu immédiatement après une requête réussie avec cette méthode (sans qu'il soit nécessaire d'ouvrir le formulaire Pay Station nécessaire).

Octroi de biens gratuits à l'utilisateur

Vous pouvez suivre l’état d’une commande de bien gratuit en appelant à plusieurs reprises la méthode checkOrder.

Si la commande a été placée avec succès, utilisez les méthodes SDK d’affichage de l’inventaire utilisateur pour mettre à jour les données côté client de l’application.

Liens utiles