Coupons

Comment ça marche

Les campagnes de coupons sont un outil marketing conçu pour attirer de potentiels utilisateurs vers votre produit et stimuler les ventes. Lorsqu’un utilisateur utilise un coupon, il reçoit un ou plusieurs objets bonus. Les récompenses peuvent être les objets suivants :

  • packages de monnaie virtuelle
  • clés de jeu
  • objets virtuels
  • lots

Un coupon contient un code unique. Pour l’utiliser, l’utilisateur saisit ce code dans le client ou le magasin du jeu, y compris le Web Shop.

Fonctionnalités principales :

  • Configuration du nombre total d’utilisations de coupons dans le cadre de la campagne.
  • Configuration du nombre d’utilisation de coupons par utilisateur dans le cadre de la campagne.
  • Génération de plusieurs codes pour les coupons.
  • Application de restrictions régionales pour les campagnes et les objets liés à un coupon.
Note
Pour configurer des restrictions régionales pour une campagne, contactez-nous à igs@xsolla.com.

Limites :

  • Si des clés de jeu sont utilisées comme objet bonus, la clé sera envoyée à l’utilisateur par e-mail ou via le système de droits après l’utilisation. Si la campagne est à court de clés, l’utilisateur ne pourra pas utiliser le coupon.
  • Si des restrictions régionales sont appliquées à une promotion par coupon, les utilisateurs de ces régions ne pourront pas utiliser le coupon.
  • Si un coupon contient au moins un objet bonus soumis à une restriction régionale, les utilisateurs de cette région ne pourront pas obtenir cet objet avec ce coupon.
  1. Exemple : Un bouclier et une épée sont offerts comme 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 situé hors des États-Unis saisit le code du coupon, une erreur sera renvoyée en réponse aux appels Vérifier un code promotionnel ou Échanger un code de coupon. L'utilisateur ne pourra obtenir aucun des objets du coupon.
Note

Vous pouvez également configurer des promotions par codes promo pour votre magasin.

Différences clés :

  • Un coupon permet à un utilisateur de recevoir uniquement des objets bonus. Un code promo, en revanche, peut offrir des objets bonus, une remise sur un objet spécifique ou une remise sur l’ensemble du panier.

  • Les codes promo sont utilisés lors d’un achat (au moment du paiement), tandis que les coupons sont utilisés après que l’utilisateur a saisi et appliqué le code.

Flux utilisateur :

  1. Un utilisateur autorisé accède au magasin.
  2. L’utilisateur saisit le code promo.
  3. Xsolla renvoie la liste des bonus disponibles pour le coupon (facultatif).
  4. L’utilisateur sélectionne les bonus (facultatif).
  5. L’utilisateur utilise le coupon.
  6. Les objets associés au coupon sont attribués à l’utilisateur de la même manière qu’un achat standard.

Configurez une campagne par coupons

Prérequis

Avant de configurer une campagne de coupons, configurez d’abord les objets qui seront offerts en bonus.

Pour créer des objets manuellement dans le projet depuis le Compte éditeur, accédez à la section Items catalog > All items. Pour des informations détaillées sur cette méthode et les autres façons de créer des objets, consultez la section Catalogue des objets de la documentation.

Configuration dans le Compte éditeur

Pour créer une nouvelle campagne par coupon :

  1. Ouvrez le projet dans le Compte éditeur et accédez à la section LiveOps > Promotions.
  2. Dans l’onglet Promotions, appuyez sur Create promotion.
  1. Spécifiez les principaux paramètres de promotion :
    1. Spécifiez Promotion name.
    1. Dans la liste déroulante Promotion type, sélectionnez Coupon.
    1. Dans le champ External ID, indiquez un ID de promotion utilisé pour gérer les promotions par appels API.
    1. Dans la liste déroulante Select bonus items, choisissez le type d'objet à attribuer à l'utilisateur lors de l'utilisation du coupon.
Note
Un type d’objet ne peut être sélectionné que si vous avez créé au moins un objet de ce type dans le projet.

    1. Sélectionnez les objets à attribuer à l'utilisateur lors de l'utilisation du coupon.
    1. Pour les objets virtuels, précisez la quantité pour chaque objet.
    1. Pour les clés de jeu, précisez quand la plateforme sera déterminée :
      • Pour pré-attribuer une plateforme spécifique (par exemple, Steam), sélectionnez Sélectionner le DRM lors de la génération du code dans la liste déroulante Type of DRM selection. Sélectionnez ensuite la plateforme dans la liste déroulante DRM.
      • Pour laisser l'utilisateur choisir, sélectionnez Player selects DRM at redemption dans la liste déroulante Type of DRM selection.

Note

Vous pouvez choisir différents types d’objets comme bonus. Pour passer d’un type à l’autre, utilisez le champ Select bonus items. Les informations de tous les objets sélectionnés s’affichent dans la section List of bonus items.

    1. Appuyez sur Next.
  1. Configurez les limites d’utilisation des coupons :
    1. Pour limiter le nombre total d'utilisations de coupons pour tous les utilisateurs d'une campagne, réglez la bascule Limit total number of coupon redemptions sur On et indiquez le nombre maximum d'utilisations.
    1. Pour limiter le nombre de coupons qu'un utilisateur unique peut utiliser dans le cadre d'une campagne, réglez la bascule Limit total number of redemptions per user sur On et indiquez le nombre maximum d'utilisations par utilisateur.
    1. Pour limiter le nombre de fois qu'un code promo unique peut être utilisé par tous les utilisateurs, réglez la bascule Limit number of unique coupon code redemptions sur On et indiquez le nombre maximum d'utilisations pour le coupon.
    1. Appuyez sur Next.
  1. Spécifiez la période de validité de la campagne : fuseau horaire, date de début et date de fin. Pour créer une campagne sans date de fin, cochez la case No end date.
  2. Appuyez sur Next.
  3. Révisez les paramètres de la campagne.
  4. Appuyez sur Save and exit.

Pour ajouter des codes de coupon à une campagne :

  1. Ouvrez le projet dans le Compte éditeur et accédez à la section LiveOps > Promotions.
  2. Dans la ligne de la promotion par coupon, appuyez sur ••• et sélectionnez Edit promotion dans la liste déroulante.
  1. Accédez à l’onglet Codes.
  2. Pour générer des codes automatiquement :
    1. Dans la liste déroulante Code string format, sélectionnez Auto-generated.
    1. Indiquez le nombre de codes à générer, puis cliquez sur Generate.
  1. Pour ajouter des codes manuellement :
    1. Dans la liste déroulante Code string format, sélectionnez Manually entered.
    1. Entrez le code de coupon et appuyez sur Create.
    1. Répétez l'étape précédente pour ajouter le nombre de codes requis.
  1. Téléchargez un fichier CSV contenant les codes (facultatif).
Note

Les codes de coupon sont sensibles à la casse. Par exemple, winter123 et WINTER123 sont considérés comme des coupons distincts.

Vous pouvez ajouter de nouveaux codes à une campagne autant de fois que nécessaire. Cependant, le nombre total de codes ne doit pas dépasser 50 000.

Si vous devez télécharger un grand nombre de codes générés par vos soins, veuillez nous contacter à l’adresse igs@xsolla.com.

Pour rendre la campagne accessible aux utilisateurs, activez-la. Pour ce faire :

  1. Ouvrez le projet dans le Compte éditeur et accédez à la section LiveOps > Promotions.
  2. Dans la ligne de la promotion par coupon, appuyez sur ••• et sélectionnez Edit promotion dans la liste déroulante.
  3. Dans la liste déroulante située dans le coin supérieur droit, sélectionnez Activate promotion.

Configuration via API

Avis
La liste des paramètres requis pour les appels API de mise à jour des promotions ne correspond pas à celle renvoyée par les appels API de récupération des promotions. Lors de l’utilisation des méthodes API pour mettre à jour des promotions, vous devez fournir :
  • les paramètres obligatoires ;
  • les paramètres à modifier ;
  • tous les autres paramètres renvoyés par l’appel de récupération des promotions.

Pour configurer et gérer des campagnes de coupons via API, utilisez les appels suivants :

TâcheAppel API
Créer une promotion avec coupon.Créer une promotion par coupon.
Activer une promotion avec coupon.Activer une promotion par coupon.
Modifier une promotion.Mettre à jour une promotion par coupon avec de nouvelles options promotionnelles. Vous pouvez également modifier les promotions dont le statut est Active.
Désactiver une promotion avec coupon.Désactiver une promotion par coupon,
Configurer une promotion à durée indéterminée.Créer une promotion par coupon ou Mettre à jour une promotion par coupon. Passez le paramètre “date_end”: null aux appels indiqués.
Supprimer une promotion.Supprimer une promotion par coupon.
Note
Si vous désactivez ou supprimez une promotion active, celle-ci ne sera plus accessible aux utilisateurs.

Configurez l'utilisation des coupons dans l'application ou sur le site web.

Utilisation des coupons dans votre propre interface utilisateur

Pour permettre aux utilisateurs d’utiliser des coupons dans votre application ou sur votre site web :

  1. Implémentez les éléments suivants dans l’interface utilisateur :

    • Un champ pour saisir le code de coupon.
    • Un formulaire pour afficher les récompenses associées aux coupons.
    • Un bouton pour utiliser le code de coupon.
  2. Implémentez la logique des coupons à l’aide des appels API côté client suivants :

Note
Pour appeler les API de Xsolla, vous pouvez utiliser les méthodes SDK prêtes à l’emploi pour les moteurs de jeu et les plateformes :
TâcheAppel API
Vérifier si le coupon est correct.Vérifier un code promotionnel.
Utiliser un coupon.Échanger un code de coupon.
Obtenir la liste des plateformes de distribution de jeux à afficher à l’utilisateur lorsqu’une clé de jeu est fournie en bonus via un coupon.

Lire les récompenses d’un coupon.

Si la réponse renvoie is_selectable=true, pour chaque objet avec type=unit, affichez un formulaire permettant de choisir un élément parmi ceux de unit_items. Dans ce formulaire, l’utilisateur ne peut sélectionner qu’un seul élément par type unit.

Le paramètre type=unit est passé pour les clés de jeu. Dans ce cas, l’utilisateur sélectionne une plateforme.

Note
Pour vérifier combien de fois un utilisateur peut encore utiliser un coupon dans une campagne, utilisez l’appel API côté serveur Lire la limite de coupon pour un utilisateur spécifique.
  1. Assurez-vous que le système attribue correctement les objets à l’utilisateur lors de l’utilisation du coupon.
  1. Si vous avez déjà implémenté un magasin intégré à l'application ou au site web, aucune configuration supplémentaire n'est nécessaire. Les objets associés à un coupon sont attribués à l'utilisateur de la même façon qu'un achat standard.
Note
Les clés de jeu sont envoyées à l’utilisateur par e-mail ou via le système des droits.

Utilisation des coupons sur un site web créé avec Xsolla

Avis
Vous ne pouvez ajouter la fonctionnalité d’utilisation de coupons et de codes promo qu’aux sites web créés à l’aide du modèle Web Shop.

Pour afficher le champ de saisie du code sur le site web :

  1. Ouvrez le projet dans le Compte éditeur et accédez à la section Storefronts > Websites.
  2. Dans la section Sites, sélectionnez votre site et cliquez sur Open Site Builder.
  3. Dans la zone principale de l’éditeur, choisissez l’emplacement où vous souhaitez ajouter un nouveau bloc, puis cliquez sur Add block.
  4. Sélectionnez le bloc Promo codes.
  5. Personnalisez l’apparence du bloc (facultatif) :
    • Modifiez l’en-tête et le texte descriptif du bloc.
    • Définissez un arrière-plan personnalisé pour le bloc.
    • Modifiez le style du bouton.
    • Modifiez le texte du bouton pour utiliser un coupon.
  6. Pour appliquer les modifications, publiez le site web :

    1. Dans le coin supérieur droit du constructeur, appuyez sur Publish.
    1. Cochez les cases à côté des pages que vous souhaitez publier.
    1. Appuyez sur Publish.

Note

Si la publication du site n’est pas disponible, vérifiez que toutes les conditions sont remplies :

  • Il n’y a aucune section vide dans le constructeur (marquée d’un indicateur rouge).
  • Le contrat de licence avec Xsolla est signé.
  • La page principale est publiée ou sélectionnée pour la publication. Vous ne pouvez pas publier les pages enfant avant la page principale.
Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Dernière mise à jour: 13 Février 2026

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entrée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !
Impossible d'envoyer votre commentaire
Réessayez plus tard ou contactez-nous à doc_feedback@xsolla.com.