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 PurchaseFreeItem 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 contient à la fois des biens payants et des biens gratuits, appelez la méthode SDK Purchase de la classe Cart. Cette méthode encapsule les méthodes permettant de créer une commande, d'ouvrir l'interface de paiement et de suivre l'état de la commande.

• Si le panier ne contient que des biens gratuits, appelez la méthode SDK PurchaseFreeCart de la classe Cart. 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

Les méthodes Purchase, PurchaseFreeItem et PurchaseFreeCart permettent de suivre l’état de la commande. Lors de l’appel de ces méthodes, passez dans le paramètre onSuccess la fonction qui est appelée lorsque le statut de la commande passe à done. Mettez à jour l’inventaire côté client de l’application de l’une des manières suivantes :

• en utilisant les méthodes SDK pour afficher l'inventaire utilisateur ;
• en utilisant les données de contenu de la commande passées à la fonction de rappel onSuccess des méthodes d'achat.

Liens utiles