Créer une monnaie virtuelle

La monnaie virtuelle est de l’argent virtuel qui est utilisé pour acheter et vendre des objets dans le jeu. Selon son objectif, une monnaie virtuelle affecte l’équilibre économique du jeu ou est liée à la monétisation de l’application. Vous pouvez également créer une monnaie premium : une monnaie virtuelle qui est liée à la plateforme d’achat et qui ne peut être obtenue qu’en échange d’argent réel.

La monnaie virtuelle peut être vendue en quantités prédéfinies. Pour un package donné, vous pouvez définir un prix spécial qui ne correspond pas nécessairement à la quantité de la monnaie virtuelle qu’il contient.

Voir la section Monnaie virtuelle pour en savoir plus sur la monnaie virtuelle.

Pour configurer la monnaie virtuelle :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > Virtual currency.
2. Appuyez sur New virtual currency.
3. Spécifiez :
   • Image (facultatif) ;
   • UGS ;
   • Nom ;
   • Prix en devise réelle ou en monnaie virtuelle ;
   • Devise par défaut ;
   • Attributs (facultatif).

4. Vous pouvez définir la monnaie virtuelle comme une monnaie premium. Cette monnaie est liée à la plateforme d'achat et vendue uniquement contre de l'argent réel. Pour stocker séparément la monnaie premium selon les plateformes, réglez la bascule Premium Currency sur On.

Configurer un package de monnaie virtuelle

Pour créer un package de monnaie virtuelle :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > Virtual Currency > Packages.
2. Appuyez sur New Package.

3. Spécifiez :
   • Image du package (facultatif) ;
   • UGS du package ;
   • Nom du package ;
   • Brève description du package ;
   • Monnaie virtuelle dans le package ;
   • Prix en devise réelle et en monnaie virtuelle ;
   • Devise par défaut ;
   • Attribut (facultatif).

4. Pour limiter le nombre de fois que l'utilisateur peut acheter un package de monnaie virtuelle, réglez la bascule Limit number of times one user can buy a virtual currency package sur On et indiquez la limite.
5. Pour définir une limite de temps pour l'affichage du package dans le magasin, dans le champ Show item in store, sélectionnez Time period et indiquez le fuseau horaire ainsi que les dates de début et de fin de la période. Si vous ne souhaitez pas indiquer de date de fin d'affichage, cochez la case No end date.
6. Vérifiez les paramètres et cliquez sur Create package.

Créer des objets virtuels

Les objets virtuels sont le contenu du jeu que vous pouvez vendre contre des devises réelles et de la monnaie virtuelle.

Il existe 3 types d’objets virtuels :

• Consommables – objets que l’utilisateur peut avoir en grande quantité et acheter plusieurs fois. Leur quantité diminue lorsqu’il les utilise.
• Non consommables – objets qui ne peuvent être obtenus ou achetés qu’une seule fois. Ils sont conservés dans l’inventaire de l’utilisateur et ne peuvent pas être retirés de l’inventaire en étant consommés côté client. Vous ne pouvez les retirer que côté serveur.
• Objet à durée limitée – objet non consommable disponible pendant une période limitée et qui ne disparaît pas de l’inventaire à son expiration. L’utilisateur doit acheter à nouveau cet objet pour l’activer.

Voir la section Objets virtuels pour en savoir plus sur les objets virtuels.

Pour configurer des objets virtuels, vous devez d’abord configurer des groupes d’objets virtuels. Ces groupes vous permettent de disposer d’un catalogue à plusieurs niveaux et de gérer l’affichage des objets dans le magasin.

Pour créer des groupes d’objets virtuels :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > Virtual items.
2. Appuyez sur + et sélectionnez Create group dans la liste déroulante.

3. Spécifiez les paramètres suivants :
   • Code du groupe ;
   • Nom du groupe.
4. Pour afficher le groupe dans le catalogue, réglez la bascule Show group in Store sur On.

5. Cliquez sur Create group.

Pour créer un objet virtuel :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > Virtual Items.
2. Appuyez sur + et sélectionnez Create Item dans la liste déroulante.

3. Spécifiez :
   • Image (facultatif) ;
   • UGS ;
   • Un ou plusieurs groupes auxquels l'objet doit appartenir ;
   • Nom ;
   • Description (facultatif).

• Propriété de l'objet : objets consommables, non consommables ou à durée limitée ;
• Prix en devises réelles ou en monnaie virtuelle.

4. Définissez une limite d'achat pour l'objet (facultatif). Pour ce faire, réglez la bascule Limit number of times one user can buy this item sur On et indiquez le nombre d'objets que l'utilisateur peut acheter.
5. Pour définir une limite de temps pour l'affichage de l'objet dans le magasin, dans le champ Show item in store, sélectionnez Time period et indiquez le fuseau horaire ainsi que les dates de début et de fin de la période. Si vous ne souhaitez pas indiquer de date de fin d'affichage, cochez la case No end date.
6. Vérifiez les paramètres et cliquez sur Create item.

Créer des lots

Un lot est un ensemble de plusieurs biens vendus en une seule unité. Vous pouvez ajouter des biens de différents types à un lot :

• Monnaie virtuelle ;
• Package de monnaie virtuelle ;
• Objets virtuels, y compris des objets à durée limitée ;
• Lots.

Voir la section Lots pour en savoir plus sur les lots.

Pour créer un lot :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Items catalog > Bundles.
2. Appuyez sur + et sélectionnez Create bundle dans la liste déroulante.

3. Spécifiez :
   • Image (facultatif) ;
   • UGS ;
   • Nom ;
   • Description (facultatif) ;
   • Contenu.
4. Définissez le prix du lot. Définissez le prix ou créez un lot gratuit :
   1. Pour créer un lot gratuit, dans le champ Paid or Free, sélectionnez Free bundle ;
   2. Pour définir un prix, dans le champ Paid or Free, sélectionnez Paid bundle et indiquez le prix en devises réelles ou en monnaies virtuelles. Si nécessaire, configurez les prix régionaux.

5. Définissez une limite d'achat pour le lot (facultatif). Pour ce faire, réglez la bascule Limit number of times one user can buy bundle sur On et indiquez le nombre de lots que l'utilisateur peut acheter.
6. Cliquez sur Next.
7. Configurez l'affichage du lot dans le magasin :
   • Changez le statut en Available ;
   • Définissez une période de temps limitée pour l'affichage du lot dans le magasin (facultatif). Pour ce faire, sélectionnez Time period et indiquez le fuseau horaire ainsi que les dates de début et de fin de la période. Si vous ne souhaitez pas indiquer de date de fin de la période d'affichage du bien, cochez la case No end date.
8. Cliquez sur Next.
9. Vérifiez les paramètres et cliquez sur Save.

Utilisez les appels Shop Builder API pour automatiser la création et la mise à jour du catalogue. Grâce à l’automatisation, vous pouvez maintenir votre catalogue à jour sans y consacrer beaucoup de temps. L’automatisation du catalogue vous permet de créer et de mettre à jour des objets et des promotions et d’importer des données à partir de systèmes externes.

Une autorisation de base est requise pour utiliser les appels API de création et de mise à jour des objets et des promotions. Passez le code Authorization:Basic <your_authorization_basic_key>, où <your_authorization_basic_key> est la paire merchant ID:API key encodée conformément à la norme Base64. Accédez au Compte éditeur pour trouver les paramètres suivants :

• Merchant ID est affiché :
  • Dans la section Company settings > Company ;
  • Dans l'URL de la barre d'adresse du navigateur sur n'importe quelle page du Compte éditeur. L'URL est au format suivant : https://publisher.xsolla.com/<merchant_id>/.

• L'API key ne s'affiche dans le Compte éditeur qu'une seule fois lors de sa création, vous devez donc la conserver de votre côté. Vous pouvez créer une nouvelle clé dans les sections suivantes :
  • Company settings > API keys ;
  • Project settings > API keys.

Pour créer des objets via API :

1. Exporter les données sur les objets depuis votre système.
2. Convertir les données exportées dans un format correspondant à celui des données de l’appel API pour le type d’objet requis.
3. Créer un script qui appelle la méthode API requise pour chaque objet exporté :
   • Créer un objet virtuel ;
   • Créer une monnaie virtuelle ;
   • Créer un package de monnaie virtuelle ;
   • Créer un lot.

Si vous souhaitez utiliser des groupes d’objets, créez-les à l’avance dans le Compte éditeur.

1. Ouvrez votre projet dans le Compte éditeur et dans la section Catalogue d’objets, accédez au type d’objet correspondant que vous souhaitez configurer :
   • Monnaie virtuelle
   • Objets virtuels
   • Clés de jeu
   • Lots
2. Dans la liste déroulante Gestion du catalogue, sélectionnez Importer des objets (JSON).

3. Choisissez l'action :
   • Add new items — seuls les objets avec de nouvelles UGS seront ajoutés ;
   • Add new items and update existing ones — les objets avec de nouvelles UGS seront ajoutés et les données des objets existants seront mises à jour ;
   • Add new, update existing, disable missing items — les objets avec des UGS provenant du fichier seront ajoutés/mis à jour. S'il existe un objet dans le catalogue, mais qu'il n'y a pas d'UGS correspondante dans le fichier, le statut de l'objet dans le Compte éditeur sera changé en Partially available — l'objet ne peut pas être acheté séparément, mais est disponible dans le cadre d'un lot ou d'un bonus.

4. Remplissez le fichier pour l'importation :
   • Téléchargez le modèle de fichier dans la fenêtre de téléchargement et remplissez-le selon l'exemple ci-dessous ;
   • Exportez les objets et utilisez le fichier exporté comme modèle ;
   • Créez votre propre fichier JSON et remplissez-le selon l'exemple ci-dessous.

Exemple de fichier JSON complet :

  1{
  2    "virtual_currency": [
  3        {
  4            "sku": "Gem_test_import",
  5            "name": {
  6                "en": "Gem_test_import"
  7            },
  8            "type": "virtual_currency",
  9            "description": {
 10                "en": "my test imported currency"
 11            },
 12            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
 13            "description": {
 14                "en": "my test imported currency",
 15                "de": "meine importierte Testwährung"
 16            },
 17            "attributes": [],
 18            "is_free": false,
 19            "order": 1,
 20            "groups": [],
 21            "regional_prices": [],
 22            "prices": [
 23                {
 24                    "amount": 2,
 25                    "currency": "USD",
 26                    "is_default": true,
 27                    "is_enabled": true
 28                }
 29            ],
 30            "media_list": [],
 31            "vc_prices": [],
 32            "is_enabled": true,
 33            "is_show_in_store": true,
 34            "regions": [],
 35            "limits": {
 36                "per_user": null,
 37                "per_item": null,
 38                "recurrent_schedule": null
 39            },
 40            "periods": [],
 41            "inventory_options": {
 42                "consumable": true,
 43                "expiration_period": null
 44            },
 45            "is_hard": false
 46        }
 47    ],
 48    "virtual_items": [
 49        {
 50            "sku": "event_access_test_import",
 51            "name": {
 52                "en": "Special Event Access_test_import"
 53            },
 54            "type": "virtual_good",
 55            "description": {
 56                "en": "Get special event access as a bonus only on your first purchase. Find the right doggy at the Robo-Dog Exhibition!"
 57            },
 58            "image_url": "https://cdn3.xsolla.com/img/misc/images/1e3ef1a96cc9dd8d98bc124d5d6fad79.png",
 59            "long_description": null,
 60            "attributes": [],
 61            "is_free": false,
 62            "order": 1,
 63            "groups": [
 64                "my_test_group"
 65            ],
 66            "regional_prices": [],
 67            "prices": [
 68                {
 69                    "amount": 35,
 70                    "currency": "USD",
 71                    "is_default": true,
 72                    "is_enabled": true
 73                }
 74            ],
 75            "media_list": [],
 76            "vc_prices": [],
 77            "is_enabled": true,
 78            "is_show_in_store": true,
 79            "regions": [],
 80            "limits": {
 81                "per_user": null,
 82                "per_item": null,
 83                "recurrent_schedule": null
 84            },
 85            "periods": [],
 86            "inventory_options": {
 87                "consumable": true,
 88                "expiration_period": null
 89            }
 90        }
 91    ],
 92    "virtual_currency_packages": [
 93        {
 94            "item_id": 441982,
 95            "sku": "small_gold_pack_test_import",
 96            "type": "bundle",
 97            "name": {
 98                "en": "Small gold pack"
 99            },
100            "bundle_type": "virtual_currency_package",
101            "description": {
102                "en": "Gold x100"
103            },
104            "image_url": "https://cdn3.xsolla.com/img/misc/images/ba43c46ea75fd5713c210f5736993a92.png",
105            "vc_prices": [],
106            "regional_prices": [],
107            "prices": [
108                {
109                    "amount": 5,
110                    "currency": "USD",
111                    "is_default": true,
112                    "is_enabled": true
113                }
114            ],
115            "is_enabled": true,
116            "is_show_in_store": true,
117            "regions": [],
118            "limits": {
119                "per_user": null,
120                "per_item": null,
121                "recurrent_schedule": null
122            },
123            "periods": [],
124            "attributes": [],
125            "long_description": null,
126            "media_list": [],
127            "order": 100000000,
128            "is_free": false,
129            "groups": [],
130            "content": [
131                {
132                    "sku": "Gem_test_import",
133                    "quantity": 100
134                }
135            ]
136        }
137    ],
138    "bundles": [
139        {
140            "item_id": 684024,
141            "sku": "start_pack_test_import_test_import",
142            "type": "bundle",
143            "name": {
144                "en": "Legendary Start Pack"
145            },
146            "bundle_type": "standard",
147            "description": {
148                "en": "Crystal x 1\nGem x 1"
149            },
150            "image_url": "https://cdn3.xsolla.com/img/misc/merchant/default-dc-image.png",
151            "regional_prices": [],
152            "prices": [
153                {
154                    "amount": 20,
155                    "currency": "USD",
156                    "is_default": true,
157                    "is_enabled": true
158                }
159            ],
160            "virtual_prices": [],
161            "is_enabled": true,
162            "is_show_in_store": true,
163            "regions": [],
164            "limits": {
165                "per_user": null,
166                "per_item": null,
167                "recurrent_schedule": null
168            },
169            "periods": [],
170            "attributes": [],
171            "long_description": null,
172            "media_list": [],
173            "order": 5,
174            "is_free": false,
175            "groups": [
176                "my_test_group"
177            ],
178            "content": [
179                {
180                    "sku": "Gem_test_import",
181                    "quantity": 1
182                },
183                {
184                    "sku": "event_access_test_import",
185                    "quantity": 1
186                }
187            ]
188        }
189    ]
190}

5. Téléchargez le fichier dans le champ correspondant de la fenêtre d’importation.
6. En cas d’erreurs lors de l’importation, une liste de celles-ci avec les recommandations de correction s'affiche dans la fenêtre d'importation. Apportez les modifications nécessaires au fichier et téléchargez-le à nouveau.

Après le téléchargement réussi, les objets avec les UGS spécifiées seront créés, mis à jour ou désactivés.

Vous pouvez également importer des éléments à l’aide de l’appel API Importer des éléments via un fichier JSON.

Si vous créez un site avec le modèle Web Shop ou Single game page, le bloc est ajouté automatiquement au site.

Si vous créez un site avec d’autres modèles, suivez ces étapes pour ajouter le bloc Store :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section Storefronts > Websites.
2. Appuyez sur Open Site Builder.

3. Cliquez sur Add Block dans le modèle de site.
4. Dans la liste, sélectionnez le bloc Store.

5. Dans la liste déroulante, choisissez le type et le groupe d'objet que vous souhaitez vendre sur le site.

6. Pour vendre différents types d'objet, ajoutez des sections de magasin. Pour ce faire, dans le menu du bloc Store, cliquez sur Add Store Section.
7. Pour vendre des objets dans différentes parties du site, ajoutez des blocs Store.

Vous pouvez ajouter un bouton pour l’achat rapide d’un objet dans n’importe quel modèle à l’intérieur des blocs suivants :

• Card grid ;
• Header ;
• Call-to-action ;
• Game editions ;
• Promo Slider.

Dans le modèle Single game page, le bouton se trouve également dans le bloc Lead.

Pour personnaliser le bouton :

1. Accédez à l’un des blocs spécifiés.
2. Dans la partie droite de Site Builder, accédez au bouton.
3. Dans la liste déroulante de Action, sélectionnez Purchase Item.
4. Dans la liste déroulante Item, choisissez le produit.