Comment grouper et trier les objets dans le catalogue

Ajoutez des objets dans des groupes pour créer un catalogue à plusieurs niveaux. Le groupe peut inclure différents ou les mêmes types de biens :

• Objets virtuels ;
• Monnaie virtuelle ;
• Packages de monnaie virtuelle ;
• Lots ;
• Clés de jeu.

Principales fonctionnalités :

• Ajouter le même objet dans plusieurs groupes.
• Ajouter des groupes plus petits à des groupes plus grands pour créer un catalogue à plusieurs niveaux.
• Modifier l’ordre des groupes.
• Modifier l’ordre des objets.

Configurez des groupes de l’une des manières suivantes :

• dans le Compte éditeur (uniquement pour les objets virtuels) ;
• via appels API.

Configuration dans le Compte éditeur

Créer un groupe

Pour créer un groupe d’objets virtuels :

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Store.
3. Dans le volet Virtual items, cliquez sur :
   • Connect — si vous n’avez pas d’objets virtuels ;
   • Configure — si vous avez déjà connecté des objets virtuels.
4. Cliquez sur + et sélectionnez Create group dans la liste déroulante.

5. Spécifiez les paramètres suivants :
   • External ID — code de groupe unique ;
   • Group name.
6. Réglez la bascule Show group in Store sur On.
7. Cliquez sur Create group.

Modifier un groupe

Pour modifier un groupe :

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 ••• et dans la liste déroulante, sélectionnez Edit group.

4. Effectuez les modifications nécessaires.

5. Cliquez sur Save Changes.

Ajouter un objet au groupe

Trier les objets

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Store.
3. Dans le volet Virtual items, cliquez sur :
   • Connect — si vous n’avez pas d’objets virtuels ;
   • Configure — si vous avez déjà connecté des objets virtuels.
4. Accédez au groupe.
5. Survolez le numéro de l’objet virtuel avec la souris. L’icône ☰ s’affiche. Faites glisser l’objet virtuel vers la nouvelle position.

Configuration via des appels API

Ajouter un objet au groupe

Pour ajouter un objet à un groupe existant via appels API, passez un tableau contenant le paramètre external_id des groupes auxquels l’objet doit appartenir dans le champ group :

• Clés de jeu — Utilisez les appels API CCréer un jeu, Mettre à jour un jeu par UGS et Mettre à jour un jeu par ID.
• Éléments virtuels - Utilisez les appels API Créer un objet virtuel et Mettre à jour un objet virtuel.
• Monnaie virtuelle — Utilisez les appels API Créer un objet virtuel et Mettre à jour un objet virtuel.
• Package de monnaie virtuelle — Utilisez les appels API Créer un package de monnaie virtuelle et Mettre à jour un package de monnaie virtuelle.
• Lots — Utilisez les appels API Créer un lot et Mettre à jour un lot.

Exemple de requête :

{
   "sku": "sword",
   "name": {
      "en": "Sword",
   },
   "is_enabled": true,
   "is_free": false,
   "order": 1,
   "description": {
      "en": "A sword is a bladed melee weapon intended for cutting or thrusting that is longer than a knife or dagger, consisting of a long blade attached to a hilt.",
   },
   "prices": [
      {
         "amount": 100,
         "currency": "USD",
         "Is_enabled": true,
         "is_default": true
      }
   ],
   "vc_prices": [ ],
   "is_show_in_store": true,
   "groups": [
   "chests", "bonus"
],
}

Obtenir la liste des groupes

Filtrer les objets

1. Récupérez la liste des objets via les appels API suivants :
   • Clés de jeu — Appel API Lire une liste de jeux ;
   • Monnaie virtuelle — Appel API Lire une liste de monnaies virtuelles Appel API ;
   • Packages de monnaie virtuelle — Appel API Get virtual currency package list ;
   • Lots — Appel API Get list of bundles.
2. En utilisant le filtrage, trouvez les objets avec le paramètre external_id du groupe requis spécifié dans le paramètre groups.