Clés de jeu gratuites

Comment ça marche

Les clés de jeu gratuites sont un type de bien que l’utilisateur peut obtenir sans dépenser de monnaie virtuelle ou de devises réelles.

Exemples d’utilisation :

1. Octroi de DLC gratuits aux utilisateurs qui possèdent déjà le jeu principal pour les récompenser de leur fidélité.
2. Octroi de jeux pour une durée limitée afin d’attirer de nouveaux utilisateurs.

Comment configurer

1. Créez une clé de jeu gratuite de l'une des manières suivantes :
   • via le Compte éditeur ;
   • via les appels API.
2. Configurez la livraison de clés de jeu gratuites.

Création dans le Compte éditeur

Pour créer une clé de jeu gratuite :

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Store.
3. Dans le volet Game key, cliquez sur :
   • Connect — si vous n’avez pas de clés de jeu ;
   • Configure — si vous avez déjà connecté des clés de jeu.
4. Dans l’onglet Game keys, cliquez sur New game key package > Create manually.
5. Définissez les paramètres de base du package :
   • UGS ;
   • Titre du jeu ;
   • Attributs (facultatif).
6. Cliquez sur Save and continue.
7. Sélectionnez les plateformes de distribution du jeu et téléchargez un fichier CSV ou TXT contenant les clés.
8. Si vous souhaitez vendre le jeu avant sa sortie officielle, réglez la bascule Pre-orders sur On. Vous pouvez spécifier la date de sortie à laquelle les clés de jeu seront livrées aux utilisateurs lors de la création des clés ou ultérieurement.
9. Cliquez sur Save and continue.
10. Activez la bascule Free game key.
Si le jeu est publié sur la plateforme Steam, vous pouvez importer les paramètres de tarification depuis cette plateforme. Pour ce faire, cliquez sur Import via link et spécifiez le lien vers votre jeu sur Steam.
11. Vous pouvez définir une limite pour l’achat de clé de jeu. Pour ce faire, réglez la bascule Limit the number of times one user can buy game key sur On et spécifiez le nombre de clés que l’utilisateur peut acheter.

12. Cliquez sur Save and continue.

Pour apporter des modifications au package de clés de jeu créé, sélectionnez la clé dans l’onglet Game Keys, apportez les modifications nécessaires et enregistrez.

Création via appels API

1. Pour créer des clés de jeu gratuites, utilisez les appels API de la sous-section Admin dans le groupe de méthodes Game keys. Lors de la création ou de la modification d'un objet, passezis_free = true dans le corps de la requête. Ce paramètre se trouve dans un tableau d'objets unit_items dans le corps de la requête.
2. Pour créer une commande avec des objets gratuits, appelez l'API Create order with specified free item.
3. Get a user's order status.

Configurer la livraison de clés de jeu gratuites

Achat rapide

Si l’utilisateur utilise l’achat rapide (l’utilisateur n’utilise pas de panier), appelez alors l’API Create order with specified free item pour lui permettre de recevoir des clés gratuites. La livraison des clés de jeu gratuites dans l’inventaire de l’utilisateur a lieu immédiatement après une requête réussie de cette méthode (sans qu’il soit nécessaire d’ouvrir le formulaire de paiement de Pay Station).

Achat via le panier

Si l’utilisateur utilise le panier :

• Si le panier de l’utilisateur contient à la fois des biens payants et gratuits, utilisez les appels API standard Create order with all items from particular cart et Create order with all items from current cart pour créer des commandes. L’utilisateur paiera la commande au moyen du formulaire de paiement de Pay Station.
• Si le panier de l’utilisateur ne contient que des biens gratuits, utilisez les appels API Create order with free cart et Create order with particular free cart pour récupérer le panier gratuit. Dans ce cas, l’interface de paiement ne sera pas utilisée, et les paiements sont traités automatiquement. Un formulaire s’ouvrira, demandant à l’utilisateur de fournir une adresse e-mail. La commande est ensuite passée et l’utilisateur est redirigé vers la page d’état de la commande.

Dernière mise à jour: 22 Janvier 2024