Biens gratuits

Les biens gratuits sont le 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 ;
• Clés de jeu ;
• 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.

Qui peut l'utiliser

• Les partenaires qui ont déjà un magasin en en ligne et qui souhaitent créer un nouveau type de produit : les biens gratuits.
• Les partenaires qui souhaitent fidéliser leurs utilisateurs actuels ou attirer de nouveaux joueurs.

Flux d'intégration

Les biens gratuits peuvent être créés :

• dans le Compte éditeur ;
• via appels API.

Création dans le Compte éditeur

Pour créer un bien gratuit (sur la base de l’exemple des objets virtuels) :

1. Ouvrez votre projet dans le Compte éditeur.
2. Cliquez sur Store dans le menu latéral.
3. Dans le volet Virtual Items, cliquez sur Configure.
4. Cliquez sur l’icône + et choisissez Create group dans la liste déroulante.
5. Spécifiez :
   • l’ID externe ;
   • le nom du groupe.
6. Cliquez sur Create group et accédez au groupe.
7. Cliquez sur Create item.
8. Spécifiez :
   • l’image ;
   • l’UGS ;
   • le ou les groupes auxquels l’objet doit appartenir ;
   • le nom ;
   • la description ;
   • la propriété de l’objet : consommable, non consommable ou objet à durée limitée.

9. Dans le bloc Price settings, choisissez Free item.
10. Si vous souhaitez limiter la disponibilité des objets à des utilisateurs spécifiques, réglez la bascule Limit number of times one user can buy this item sur On et spécifiez le nombre.
11. Si vous souhaitez afficher un article dans le magasin, réglez le bouton Show item in store sur On.
12. Cliquez sur Create item.

Création via appels API

1. Pour créer des biens gratuits, utilisez les appels API de la sous-section Admin :
   • Pour les objets virtuels — Create virtual item ;
   • Pour les packages de monnaie — Create virtual currency package ;
   • Pour les lots — Create bundle.
   Lorsque vous créez ou modifiez un bien, passez is_free = true dans le corps de la requête.
2. Obtenez le statut de la commande de l' utilisateur.
3. Si vous souhaitez limiter la disponibilité des biens à des utilisateurs spécifiques, appelez n'importe quelle méthode API de création ou de modification d'un bien et spécifiez la valeur du paramètre limits.per_user.

Configuration dans le magasin en ligne

Pour afficher des biens gratuits dans le magasin en ligne :

1. Ouvrez votre projet dans le Compte éditeur et accédez à Site Builder.
2. Dans la section Site, choisissez votre site et cliquez sur Configure.
3. Dans le bloc Store, accédez à la section Store.
4. Dans le champ Select purchase type, sélectionnez les biens gratuits que vous avez ajoutés précédemment.

Dernière mise à jour: 22 Janvier 2024