Lots

Comment ça marche

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

Fonctionnalités principales :

• Ajout d’objets de types différents à 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 de la tarification du lot en devises réelles et en monnaies virtuelles. Vous pouvez définir des prix dans plusieurs devises réelles ou monnaies virtuelles. Dans ce cas, sélectionnez une devise par défaut.
• Définition de prix régionaux pour les lots.
• Limitation du nombre de lots disponibles à l’achat.
• Définition d’une durée d’affichage des lots dans le magasin.
• Restriction de la disponibilité des lots par région.

Restrictions :

• Vous ne pouvez pas ajouter le même lot au lot.
• Vous ne pouvez pas créer un lot vide.
• Si un lot inclut des clés et que les clés disponibles sont épuisées, la vente de ce lot est mise en pause.
• La définition de restrictions régionales pour les lots n’est disponible que via des appels API.

Comment configurer

Pour créer un lot :

2. Cliquez sur Create manually et sélectionnez Bundle dans la liste déroulante.

3. Dans la section General settings, indiquez les éléments suivants :
   • SKU
   • Un ou plusieurs groupes auxquels l’objet doit appartenir (facultatif)
   • Nom
   • Description courte
   • Description détaillée — pour l’ajouter, activez la bascule correspondante (facultatif)

4. Dans la section Media, téléchargez une ou plusieurs images ou vidéos (facultatif) — depuis votre appareil ou via un lien. Dans le magasin créé avec l’éditeur de site Xsolla, toutes les fiches d’objet affichent le fichier marqué Main, tandis que les autres fichiers ne sont disponibles que dans celles qui incluent une galerie de médias. Le fichier marqué Main est également renvoyé dans les réponses des appels API de récupération du catalogue.

5. Dans la section Bundle items, sélectionnez les SKU à ajouter au lot. Au moins un objet est requis.

6. Dans la section Price settings, définissez les prix ou créez un objet gratuit :
   • Pour définir un prix, sélectionnez Paid item, activez les bascules Pricing in real currency et/ou Pricing in virtual currency, puis indiquez le prix. Si nécessaire, configurez les prix régionaux.
   • Pour créer un objet gratuit, sélectionnez Free item.

7. Pour limiter le nombre d’objets disponibles à l’achat :
   1. Activez la bascule dans la section Limits et indiquez la quantité.
   2. Configurez la fréquence de réinitialisation de la limite. Pour cela, sélectionnez une période dans la liste déroulante :
      • Daily.
      • Weekly.
      • Monthly.
      • Custom interval. L’intervalle est calculé à partir de la date de début d’affichage de l’objet dans le magasin.
      • No regular refresh.
   3. Définissez le calendrier de réinitialisation en indiquant les paramètres correspondant à la période sélectionnée.

8. Pour configurer une durée d’affichage limitée pour l’objet (facultatif) :

   1. Activez la bascule dans la section Add specific display period.
   2. Indiquez le fuseau horaire ainsi que le début et la fin de la période.

   Pour laisser la fin de la période d’affichage de l’objet indéfinie, activez la bascule No end date.

9. Configurez les attributs à l’aide de l’une des options suivantes (facultatif) :
   1. Ajoutez des attributs et leurs valeurs au format JSON.
   2. Créez manuellement des attributs et leurs valeurs et liez-les aux objets.

10. Si l’objet payant est utilisé dans un mécanisme de récompense aléatoire (par exemple, loot boxes ou gachas), activez la bascule Mark as paid randomized reward.

11. Cliquez sur Create.

12. Dans la fenêtre qui s’ouvre, sélectionnez le statut de l’objet et cliquez sur Continue.

L’objet créé apparaît dans la section All items.

Configurer via l’API

Pour configurer des lots, vous pouvez utiliser les appels API de la sous-section Admin dans le groupe Bundles.

Pour ajouter une clé de jeu pour une plateforme sélectionnée à un lot, passez le tableau content avec les SKU des plateformes nécessaires aux appels Create bundle ou Update bundle.

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

Pour limiter le nombre de lots disponibles à l’achat, utilisez les appels API Create bundle ou Update bundle avec les paramètres suivants :

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

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

Afficher les lots dans le magasin

Les lots s’affichent dans le catalogue selon l’implémentation — via l’éditeur de site ou via l’API.

Afficher via l’éditeur de site

Pour afficher lles lots sur le site web :

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

1. Créer des lots.

2. Dans votre projet dans le compte pour les jeux mobiles, accédez à la section Web Shop.

3. Cliquez sur le volet du site souhaité.

4. Si votre site comprend plusieurs pages, sélectionnez celle qu’il vous faut :

   1. Cliquez sur le titre de la page actuelle en haut de l’éditeur.
   2. Sélectionnez la page nécessaire dans la liste déroulante.

5. Dans le bloc Store, accédez à la section Store.

6. Dans le champ Item type, sélectionnez Bundles.

7. Dans le champ Item group, sélectionnez leur groupe.
8. Choisissez une disposition de carte d’objet.

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

10. Après avoir effectué toutes les modifications nécessaires et préparé votre site web pour le lancement :

    1. Dans le coin supérieur droit de l’éditeur de site, cliquez sur Publish.
    2. Cochez les cases en face des pages que vous souhaitez publier.
    3. Cliquez sur Publish.

Une fois le site publié, une section avec des lots devient disponible. Si aucun lot n’est affiché, vérifiez que leur statut est défini sur Available et qu’aucune limite d’affichage basée sur le temps n’est active.

Obtenir des informations sur les lots via l’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 :

• Obtenir la liste des lots
• Obtenir la liste des lots par groupe spécifié
• Obtenir le lot spécifié

Configurer les webhooks

Vous pouvez configurer quelles données sur les objets sont incluses dans les webhooks Successful payment for order et Order cancellation via le tableau items.

Accorder des 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 sont automatiquement ajoutés à l’inventaire PlayFab de l’utilisateur.
• Si vous utilisez un système de distribution personnalisé, toutes les monnaies et tous les objets virtuels sont accordés de votre côté. Nous recommandons de configurer un gestionnaire de webhook pour recevoir les données de commande sur votre backend. Les données nécessaires sont incluses dans le webhook Successful payment for order.
• Si la livraison du contenu du lot n’est pas désactivée, après l’achat d’un lot, tous les objets inclus dans le lot sont listés dans le tableau items du webhook Successful payment for order en tant qu’objets distincts. Si un lot contient un autre lot, celui-ci est également décomposé et transmis en tant qu’objets distincts.

Pour plus de détails sur ce point et d’autres méthodes de récupération des données d’achat, consultez la section Configurer le suivi du statut de la commande.