Coupons

Comment ça marche

Les campagnes de coupons permettent aux utilisateurs de recevoir des objets bonus définis dans la campagne sans effectuer d’achat. Le champ de saisie du coupon est affiché dans le catalogue.

Une fois un coupon échangé, l’utilisateur peut recevoir un objet bonus :

• clé de jeu ;
• package de monnaie virtuelle ;
• objet virtuel, y compris un lot ou un objet à durée limitée.

Fonctionnalités principales :

• limitation du nombre total d’utilisations du coupon dans le cadre de la campagne ;
• limitation du nombre d’utilisations du coupon par un utilisateur dans le cadre de la campagne ;
• génération de plusieurs codes de coupon ;
• définition de restrictions régionales de vente pour les promotions et les objets associés à un coupon.

Restrictions :

• Si des clés de jeu sont associées à un coupon en tant qu’objet bonus, une fois le coupon échangé, la clé est envoyée à l’adresse e-mail de l’utilisateur. S’il n’y a plus de clés disponibles dans la campagne, l’utilisateur ne pourra pas échanger le coupon.
• Si des restrictions régionales sont appliquées à une promotion par coupon, les utilisateurs de cette région ne peuvent pas utiliser le coupon.
• Si un coupon inclut un objet soumis à des restrictions régionales de vente, un utilisateur se trouvant dans une région où un tel objet n’est pas disponible ne pourra pas recevoir ces objets.
  Exemple : un bouclier et une épée sont offerts en bonus avec le coupon. Le bouclier est soumis à une restriction régionale et n’est disponible à l’achat qu’aux États-Unis. Si un utilisateur en dehors des États-Unis entre le code de coupon, une erreur sera renvoyée en réponse aux méthodes Verify promotion code ou Redeem coupon code. L’utilisateur ne pourra obtenir aucun des objets associés au coupon.

Flux d'intégration

1. Dans votre magasin, implémentez l'affichage d'un champ où l'utilisateur peut entrer le code de coupon.
2. Utilisez la méthode Verify promotion code pour valider le code de coupon saisi.
3. Utilisez la méthode Redeem coupon code pour échanger le coupon. Si une clé de jeu est offerte en bonus, elle est envoyée à l'adresse e-mail de l'utilisateur.

Comment configurer

Prérequis

1. Enregistrez un Compte éditeur.
2. Connectez Store et configurez les modules Virtual Items et Virtual Currency.

Configurer une promotion avec coupon

Vous pouvez configurer des promotions par coupon :

• dans le Compte éditeur ;
• via méthodes API.

Dans tous les cas, pour configurer une promotion, il est nécessaire d’implémenter des appels à des méthodes API pour vérifier l’exactitude du code de coupon et échanger le code de coupon.

Configuration dans le Compte éditeur

Si vous configurez des promotions par coupon dans le Compte éditeur, vous pouvez :

• configurer la période de validité de la promotion ;
• limiter le nombre de fois que la promotion peut être utilisée par l’utilisateur ;
• configurer des promotions qui s’appliquent à tous les types de biens :
  • packages de monnaie virtuelle ;
  • objets virtuels (y compris les objets à durée limitée) ;
  • clés de jeu ;
  • lots.

L’édition des promotions par coupon dont le statut est Active n’est actuellement pas disponible dans le Compte éditeur.

Vous pouvez utiliser les méthodes API pour accéder aux options avancées de configuration de vos promotions par coupon.

Pour configurer une promotion dans le Compte éditeur :

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Store.
3. Dans le panneau Promotions, cliquez sur :
   • Connect — si vous n’avez pas de promotions connectées ;
   • Configure — si vous avez déjà connecté de promotions.

4. Cliquez sur Create promotion.

5. Spécifiez les paramètres suivants :
   1. Saisissez le nom de la promotion.
   2. Choisissez Coupon comme type de promotion.
   3. Créez un External ID — un identifiant de promotion unique utilisé pour gérer les promotions via les méthodes API.
   4. Choisissez les objets bonus que l'utilisateur reçoit lorsqu'il échange un code de coupon :
      • package de monnaie virtuelle ;
      • clé de jeu ;
      • objet virtuel (un ou plusieurs, y compris les lots et les objets à durée limitée).

6. Spécifiez le nombre total d'utilisations et le nombre d'utilisations par utilisateur.

7. Définissez les dates de début et de fin de la campagne.

8. Vérifiez les paramètres et enregistrez la promotion.

9. Accédez au menu d'édition de la promotion.
10. Dans le menu Codes, choisissez la méthode de génération de coupons.
11. Générez le code de coupon ou saisissez-le manuellement.
12. Enregistrez les modifications.
13. Activez la promotion.

Coupon avec package de monnaie virtuelle

Pour créer un coupon de package de monnaie virtuelle, vous devez d’abord spécifier le package de monnaie à utiliser. Voici les étapes à suivre :

1. Accédez aux paramètres du module Virtual currency et spécifiez les paramètres suivants :
   • Image ;
   • SKU ;
   • Currency name ;
   • Price of one unit of virtual currency ;
   • Default currency.
2. Créez le nombre requis de packages de monnaie et spécifiez les paramètres suivants pour chacun d’entre eux :
   • Image ;
   • SKU ;
   • Name ;
   • Description ;
   • Used currency ;
   • Amount of currency in a package ;
   • Price ;
   • Default currency.
3. Activez l’affichage des packages de monnaie dans Magasin.

Coupon avec clé de jeu

Pour créer un coupon de clé de jeu, vous devez spécifier le SKU de clé de jeu et les informations DRM. Vous avez 2 options :

• Générer des coupons pour le DRM déjà configuré — le paramètre est prédéfini lors de la génération des coupons ;
• Permettre à l’utilisateur de choisir un DRM lors de l’utilisation du coupon.

Coupon avec objets virtuels

Pour créer un coupon d’objet virtuel, vous devez spécifier le SKU de l’objet virtuel et sa quantité. Vous pouvez choisir un ou plusieurs objets avec des SKU différents pour un seul coupon, y compris des lots et des objets à durée limitée.

Génération des coupons

Une campagne peut inclure un ou plusieurs coupons. Le format du coupon offre deux options :

1. Chaîne saisie manuellement — adaptée à une campagne comportant un seul coupon pouvant être utilisé plusieurs fois (128 caractères au maximum).
2. Chaîne générée — ligne de chiffres et de symboles latins (10 caractères). Convient aux campagnes avec de nombreux coupons.

Pour générer des coupons, utilisez l’éditeur de promotion après avoir créé une promotion par coupon. Vous pouvez générer un code à plusieurs reprises. Le téléchargement des codes saisis manuellement est effectué sur demande par e-mail à Xsolla.

Restrictions régionales

Les restrictions régionales s’appliquent à l’ensemble de la campagne promotionnelle. Les restrictions régionales sont appliquées sur demande par e-mail à Xsolla.

Configuration via des méthodes API

Pour configurer les promotions par coupon, utilisez les méthodes de la sous-section Coupons du groupe de méthodes Promotions.

Configuration de promotion :

Vérification et application du code de coupon :Gestion des limites :Dernière mise à jour: 24 Avril 2024