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 createOrderWithSpecifiedFreeItem de la bibliothèque Store 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

Si 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 createOrderWithCart de la bibliothèque Store.
  2. Obtenez l'URL pour ouvrir l'interface de paiement. Pour ce faire, appelez la méthode createPaymentUrl de la bibliothèque Store et passez-lui le jeton de paiement et l'ID de commande.
  3. Implémentez l'ouverture de l'interface de paiement :

1. 1. 1. Pour ouvrir l'interface de paiement dans un navigateur externe, appelez la méthode statique UIApplication.shared.open et passez-lui l'URL obtenue à l'étape précédente ;
      2. Pour ouvrir l'interface de paiement dans le navigateur intégré, instanciez la classe PaystationWebView et appelez la méthode loadPaystation. Un exemple d'implémentation est fourni dans le projet de démo dans la classe PaystationVC.

• Si le panier de l'utilisateur ne contient que des biens gratuits, appelez la méthode createOrderWithFreeCart de la bibliothèque Payments. 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).

Octroi de biens gratuits à l'utilisateur

Vous pouvez suivre l’état d’une commande de bien gratuit en appelant à plusieurs reprises la méthode getOrder de la bibliothèque Store.

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