Lots

Comment ça marche

Un lot est un ensemble de plusieurs biens vendus en une seule unité.

Fonctionnalités principales :

• Ajout d’objets de différents types à un lot :
  • monnaie virtuelle ;
  • package de monnaie virtuelle ;
  • clés de jeu pour des plateformes présélectionnées ;
  • objets virtuels ;
  • lots.
• Lot gratuit.
• Configuration du prix du lot en devise réelle et en monnaie virtuelle. Vous pouvez définir des prix pour plusieurs devises réelles ou monnaies virtuelles. Dans ce cas, assurez-vous de sélectionner une par défaut.
• Définition des prix régionaux pour les lots.
• Limitation du nombre de lots disponibles à l’achat.
• Définition d’une durée maximale d’affichage des lots dans le magasin.
• Restriction de la disponibilité des lots par région.

• Un lot ne peut pas contenir le même lot.
• Un lot ne peut pas être vide.
• Si un lot contient des clés et que celles-ci sont épuisées, la vente du lot est suspendue.
• La configuration des restrictions régionales pour les lots est uniquement disponible via des appels API.

Comment configurer

Configuration dans le Compte éditeur

Pour créer un lot :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > All items.
2. Appuyez sur Add et sélectionnez Bundle dans la liste déroulante.

3. Spécifiez les paramètres suivants :
   • Image (facultative).
   • UGS.
   • Un ou plusieurs groupes auxquels le lot doit appartenir.
   • Nom.
   • Description (facultative).
4. Configurez les attributs du lot (facultatif) à l’aide de l’une des méthodes suivantes :
   • Ajoutez les attributs et leurs valeurs au format JSON.
   • Créez manuellement des attributs et des valeurs, puis associez-les à des objets spécifiques.
5. Appuyez sur Next.
6. Si la personnalisation côté partenaire est activée, vous pouvez choisir entre un lot standard ou dynamique. Les lots dynamiques permettent d’ignorer la création d’objets dans Xsolla et de renvoyer le contenu généré par votre serveur lors de la consultation du catalogue. Si la personnalisation côté partenaire est désactivée, le sélecteur de type de lot n’apparaît pas et un lot standard est créé automatiquement.

7. Ajoutez des objets au lot :
   1. Sélectionnez le type d'objet ;
   2. Indiquez une ou plusieurs UGS d'objets à inclure dans le lot ;
   3. Définissez la quantité pour chaque UGS.

8. Appuyez sur Next.
9. Définissez le prix du lot dans le champ Paid or Free :
   • Pour créer un lot gratuit, sélectionnez Free bundle.
   • Pour définir un prix, sélectionnez Paid bundle et indiquez le prix en devise réelle ou en monnaie virtuelle. Vous ne pouvez pas créer de lot dont le prix est nul. Si nécessaire, configurez les prix régionaux.
10. Pour limiter le nombre de lots disponibles à l’achat, activez la bascule Limit bundle purchases per user et entrez la quantité souhaitée.

11. Pour configurer la fréquence de réinitialisation de la limite :
    1. Dans la liste déroulante, sélectionnez une période :
       • Daily
       • Weekly
       • Monthly
       • Custom interval — l'intervalle est calculé à partir de la date de début d'affichage du lot
       • No regular refresh
    2. Configurez le calendrier de réinitialisation en fonction de la période sélectionnée.

12. Appuyez sur Next.

13. Configurez l'affichage du lot dans le magasin :
    1. Choisissez le statut ;
    2. Définissez une durée d'affichage pour le lot (facultatif) : indiquez le fuseau horaire ainsi que les dates de début et de fin. Si vous ne souhaitez pas indiquer de date de fin, cochez la case No end date.

14. Appuyez sur Next.
15. Vérifiez les paramètres et appuyez sur Save.

Configuration via API

Pour configurer des lots, utilisez les appels de la sous-section Administrateur dans le groupe Lots.

1"content": [
2  {
3     "sku": "brilliant_game_sku_steam",
4     "quantity": 1
5  }
6]

Pour limiter le nombre de lots disponibles à l’achat, utilisez l’appel API Créer un lot ou Mettre à jour un lot avec les paramètres suivants :

• limits — spécifie le nombre maximal de lots disponibles à l’achat.
• limits.recurrent_schedule — définit la fréquence à laquelle la limite est réinitialisée.

Vous pouvez également configurer la durée d’affichage du lot dans le magasin et définir des restrictions régionales.

Affichage des lots dans le magasin

Les lots sont affichés dans le catalogue selon leur mode d’implémentation : au moyen du constructeur de site ou via API.

Affichage via le constructeur de site

Pour afficher lles lots sur le site web :

1. Créez des lots.
2. Ouvrez le projet dans le Compte éditeur et accédez à la section Storefronts > Websites.
3. Dans le volet du site souhaité, appuyez sur Open Site Builder.

4. Dans le bloc Store, accédez à la section Store.
5. Dans le champ Item type, sélectionnez Bundles.

6. Dans le champ Item group, sélectionnez leur groupe.
7. Choisissez une disposition pour les cartes d’objets.

8. Si nécessaire, personnalisez la disposition en activant les bascules correspondantes dans les paramètres de disposition de la carte.

9. Après avoir effectué toutes les modifications nécessaires et préparé le site web pour le lancement :
   1. Dans le coin supérieur droit du constructeur, appuyez sur Publish.
   2. Sélectionnez les pages que vous souhaitez publier en cochant les cases correspondantes.
   3. Appuyez sur Publish.

Une fois le site publié, une section contenant les lots sera disponible. Si aucun lot n’apparaît, vérifiez que leur statut est défini sur Available et qu’aucune limite d’affichage basée sur le temps n’est active.

Obtention des informations sur les lots via API

Si le catalogue est configuré via API, les données des lots sont renvoyées par les appels disponibles dans la sous-section Catalogue :

• Lire une liste de lots
• Lire la liste des lots par groupe spécifique
• Lire un lot spécifique

Configurez les webhooks

Vous pouvez configurer les données relatives aux objets inclus dans les webhooks Paiement de commande réussi et Annulation de commande via le tableau items.

Attribuez les lots aux utilisateurs

Selon le type d’objet et les paramètres d’intégration, le lot est attribué à l’utilisateur de l’une des manières suivantes :

• Si vous avez intégré PlayFab, la monnaie virtuelle et les objets virtuels sont automatiquement ajoutés à l’inventaire PlayFab de l’utilisateur.
• Si vous utilisez un système d’attribution personnalisé, la monnaie virtuelle et les objets virtuels sont attribués de votre côté. Nous recommandons de configurer un gestionnaire de webhook pour recevoir les données de commande sur votre backend. Les informations nécessaires sont incluses dans le webhook Paiement de commande réussi.
• Si l’attribution du contenu du lot n’est pas désactivée, après l’achat d’un lot, tous les objets qu’il contient sont répertoriés dans le tableau des objets du webhook Paiement de commande réussi en tant qu’objets distincts. Si un lot inclut un autre lot, celui-ci est également déballé et son contenu est transmis comme objets distincts.

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