Codes promo et coupons

Codes promo

Les promotions par codes promo et par coupons sont une stratégie marketing utilisée pour fournir aux utilisateurs des codes leur permettant de bénéficier des objets bonus. Pour activer un code, l’utilisateur le saisit dans un champ dédié du catalogue.

Les codes promo sont utilisables au moment de l’achat, et les coupons, après que l’utilisateur a saisi un code.

La configuration d’une personnalisation est disponible avec n’importe quel type d’authentification : par ID utilisateur ou via Xsolla Login.

Flux utilisateur

L'utilisateur accède à la page de destination avec un bloc Promocodes.

L'utilisateur clique sur Log in et s'identifie par son ID utilisateur ou via Xsolla Login.
L'utilisateur saisit le code dans le champ prévu à cet effet dans l'interface, puis clique sur le bouton situé à droite de ce champ.

Une fenêtre modale s'ouvre :
- lors de l'activation d'un code promo, affichant des informations sur les réductions et les bonus ;
- lors de l'utilisation d'un coupon, affichant des informations sur les réductions et les bonus que l'utilisateur a déjà reçues.

Si le code est incorrect, l’erreur sera décrite sous le champ de saisie du code.
Exemple : la limite d’utilisation a été atteinte.

Pour les promotions par codes promo :
1. Un catalogue à jour est présenté, affichant les remises et les objets bonus disponibles en utilisant un code promo.

Avant de finaliser un achat, l’utilisateur peut annuler l’application d’un code promo, le catalogue est alors mis à jour et s’affiche sans les remises et bonus associés au code promo. Dans ce cas, le code promo n’est pas considéré comme utilisé.

L'utilisateur effectue un achat, après quoi le code promo est considéré comme utilisé.

Si des objets bonus sont associés au code promo, ils sont crédités à l’utilisateur.

Comment configurer

Pour ajouter un champ de saisie de code à votre site web :

Créez des promotions avec des codes promo ou des coupons dans la section LiveOps > Promotions.
Ajoutez un champ de saisie de code à votre site web créé avec Xsolla dans la section Storefronts > Websites.

Consultez l’onglet correspondant dans la section Comment ça marche pour obtenir des informations détaillées sur la configuration des coupons et des codes promo.

Comment ça marche

Informations générales

Les promotions par codes promo sont un outil marketing visant à stimuler le taux de conversion et à augmenter le panier moyen. Lorsqu’un code promo est appliqué à une commande, l’utilisateur peut bénéficier de ce qui suit :

une remise appliquée à l’ensemble de l’achat ou à des objets spécifiques ;
des objets bonus, notamment :
- packages de monnaie virtuelle
- clés de jeu
- objets virtuels
- lots

Fonctionnalités principales :

Configuration flexible des bonus. Vous pouvez définir un seul type de bonus (remise sur l’achat, remise sur certains objets ou objet bonus) ou toute combinaison de ces options.
Configuration du nombre total d’utilisations de codes promo dans le cadre de la campagne.
Configuration du nombre d’utilisation de codes promo par utilisateur dans le cadre de la campagne.
Génération de plusieurs codes promo.
Application de restrictions régionales pour les campagnes et les objets liés à un code promo.

Pour configurer des restrictions régionales pour une campagne, contactez-nous à [email protected].

Limites :

Un seul code promo peut être utilisé par achat.
Pour bénéficier d’une remise ou d’un objet bonus, l’utilisateur doit régler son achat.
Les remises ne s’appliquent pas aux prix en monnaie virtuelle. Pour les objets dont le prix est indiqué à la fois en devise réelle et en monnaie virtuelle, les remises ne concernent que le prix en devise réelle.
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 code promo.
Si des restrictions régionales sont appliquées à une promotion par codes promo, les utilisateurs de ces régions ne pourront pas utiliser le code promo.
Si un code promo contient au moins un objet bonus soumis à une restriction régionale, les utilisateurs de cette région ne pourront pas utiliser ce code promo.

Exemple : Un bouclier et une épée sont offerts comme bonus avec un code promo. 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 promo, une erreur sera renvoyée en réponse aux appels Vérifier un code promotionnel ou Échanger un code promo. L’utilisateur ne pourra obtenir aucun des objets du code promo.

Vous pouvez également configurer des promotions par coupon 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

L’utilisateur peut annuler l’application du code promo avant de finaliser le paiement.

Règles d'application des remises

Si plusieurs promotions sont valables pour un objet au moment de l’achat, les remises sont appliquées à l’objet une par une. L’ordre dans lequel les remises sont appliquées n’a pas d’importance.

Exemple :

Le prix d’un objet virtuel est de 10 $. Dans le Compte éditeur, les promotions suivantes ont été créées pour les objets virtuels :

Le prix d’un objet virtuel est de 10 $. Dans votre compte, les promotions suivantes ont été créées pour les objets virtuels :

promotion par réduction Black Friday avec une remise de 10 % du 4 au 30 novembre
promotion par réduction Sale avec une remise de 20 % du 15 novembre au 15 décembre
promotion par code promo avec une remise de 5 % du 4 au 30 novembre

Si l’objet est acheté le 20 novembre, les promotions par réduction et la promotion par code promo sont toutes valides.

Le prix total de l’objet virtuel est ensuite calculé comme suit : ((10 $ - 10 %) - 20 %) - 5 % = 10 $ × (100 %-10 %) × (100 %-20 %) × (100 %-5 %) = 10 $ × 0,9 × 0,8 × 0,95 et sera de 6,84 $.

Configurer une campagne avec des codes promo

Si vous souhaitez créer une promotion avec des objets bonus, vous devez d’abord configurer ces objets, puis procéder à la configuration de la promotion.

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

Vous pouvez également configurer la promotion à l’aide d’un canevas.

Pour créer une nouvelle campagne avec des codes promo :

Ouvrez le projet dans le Compte éditeur et accédez à la section LiveOps > Promotions.
Dans l’onglet Promotions, appuyez sur Create promotion.

Spécifiez Promotion name.
Dans la liste déroulante Promotion type, sélectionnez Promo code.
Dans le champ External ID, indiquez un ID de promotion utilisé pour gérer les promotions via appels API.
Pour appliquer une remise à un objet ou à l’ensemble du panier lorsqu’un code promo est utilisé :

1. Réglez la bascule Discount on purchase sur On.

1. Dans le champ Discount amount, précisez le pourcentage de la remise.

Pour appliquer une remise à des objets spécifiques lorsqu’un code promo est utilisé :

1. Réglez la bascule Discount on selected items sur On.

1. Dans le champ Discount amount, précisez le pourcentage de la remise.

1. Dans la liste déroulante Item type, sélectionnez le type d'objet qui bénéficiera d'une remise lors de l'utilisation du code promo.

1. Sélectionnez les objets.

Pour offrir des objets bonus lorsqu’un code promo est utilisé :

1. Réglez la bascule Bonus items sur On.

1. Dans la liste déroulante Select bonus items, choisissez le type d'objet à attribuer à l'utilisateur lors de l'utilisation du code promo.

1. Sélectionnez les objets à fournir lors de l'utilisation du code promo.

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.

1. Appuyez sur Next.

La remise appliquée à l’ensemble d’une commande ou à des objets spécifiques doit être un nombre entier et ne peut pas dépasser 99 %. Lorsque vous configurez des remises pour des objets spécifiques ou des objets bonus, tenez compte des éléments suivants :

Un type d’objet ne peut être sélectionné que si vous avez créé au moins un objet de ce type dans le projet.
Vous pouvez configurer des objets de différents types. Pour passer d’un type d’objet à un autre, utilisez le champ de sélection du type d’objet.

Configurez les limites d’utilisation des codes promo :

1. Pour limiter le nombre total d'utilisations de codes promo pour tous les utilisateurs dans le cadre d'une campagne, réglez la bascule Limit total number of redemptions sur On et indiquez le nombre maximum d'utilisations.

1. Pour limiter le nombre de codes promo 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 promo code redemptions sur On et indiquez le nombre maximum d'utilisations pour le code promo.

1. Appuyez sur Next.

Spécifiez la période de validité de la promotion : fuseau horaire, date de début et date de fin. Pour créer une promotion sans date de fin, cochez la case No end date.

Pour ajouter une autre période de validité à la promotion, appuyez sur +. Si une promotion comporte plusieurs périodes, chacune doit avoir une date de fin. La promotion prend fin à la dernière seconde de la minute indiquée : par exemple, si l’heure de fin est fixée à 12 h 00, elle est valable jusqu’à 12 h 00 min 59 s.

Appuyez sur Next.
Révisez les paramètres de la campagne.
Appuyez sur Save and exit.

Pour ajouter des codes promo à une campagne :

Ouvrez le projet dans le Compte éditeur et accédez à la section LiveOps > Promotions.
Dans la ligne de la promotion par code promo, appuyez sur ••• et sélectionnez Edit promotion dans la liste déroulante.

Accédez à l’onglet Codes.
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.

Pour ajouter des codes manuellement :

1. Dans la liste déroulante Code string format, sélectionnez Manually entered.

1. Entrez le code promo et appuyez sur Create.

1. Répétez l'étape précédente pour ajouter le nombre de codes requis.

Téléchargez un fichier CSV contenant les codes (facultatif).

Les codes promo sont sensibles à la casse. Par exemple, winter123 et WINTER123 sont considérés comme des codes promo 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 [email protected].

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

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

Configuration via API

Lorsque vous configurez une promotion via API, vous pouvez spécifier un montant de remise fractionnaire.

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 avec des codes promo via API, utilisez les appels suivants :

Tâche	Appel API
Créer une promotion avec code promo.	Créer une promotion par code promo.
Activer une promotion avec code promo.	Activer une promotion par code promo.
Modifier une promotion.	Mettre à jour une promotion par code promo : définir de nouvelles options de promotion. L’édition des promotions est également disponible pour les promotions avec le statut Active.
Désactiver une promotion.	Désactiver une promotion par code promo.
Configurez des périodes de validité de la promotion.	Créer une promotion par code promo ou Mettre à jour une promotion par code promo. Passez le champ `promotion_periods` en tant que tableau d’objets où `date_from` définit la date de début et `date_until` la date de fin de la période de validité. Pour qu’une promotion ait une durée indéterminée, indiquez une seule période et passez `“promotion_periods[0].date_until": null`.
Supprimer une promotion.	Delete promo code promotion

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 du code promo dans l'interface utilisateur

Dans l’interface utilisateur de l’application (dans le catalogue ou le panier), implémentez les éléments suivants :
- un champ pour la saisie du code promo
- éléments de l’interface utilisateur permettant d’afficher les récompenses et les remises liées aux codes promo
- un formulaire de sélection de récompenses liées aux codes promo (le cas échéant).
- un bouton pour appliquer le code promo
Implémentez la logique du code promo à l’aide des appels API côté client suivants :

Tâche	Appel API
Vérifier si le code promo est valide.	Vérifier un code promotionnel.
Obtenir la liste des plateformes de distribution de jeux à afficher à l’utilisateur lorsqu’une clé de jeu est fournie en bonus via un code promo.	Lire les récompenses d’un code promo. 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 de jeu.
Afficher le catalogue mis à jour en tenant compte des remises et des objets bonus lié à un code promo.	Utilisez les appels de la sous-section Catalog. Vous devez passer le code promo dans le paramètre de requête `promo_code`.
Acheter un objet spécifique directement (sans l’ajouter au panier) et utiliser un code promo.	Créer une commande à partir d’un objet spécifique. Vous devez passer le code promo dans le paramètre de requête `promo_code`.
Appliquer un code promo et mettre à jour le contenu du panier et le coût total (appliquer les remises et ajouter les objets bonus).	Échanger un code promo. Vous devez passer le code promo dans le paramètre de requête `coupon_code`.

Pour vérifier en complément combien de fois un utilisateur peut encore appliquer un code promo dans le cadre d’une campagne, utilisez l’appel API côté serveur Lire la limite de code promo pour un utilisateur spécifique.

Assurez-vous que le système attribue correctement les objets à l’utilisateur lors de l’utilisation du code promo.

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 code promo sont attribués à l'utilisateur de la même façon qu'un achat standard.

Les clés de jeu sont envoyées à l’utilisateur par e-mail ou via le système des droits.

Utilisation de codes promo sur un site web créé avec Xsolla

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 :

Ouvrez le projet dans le Compte éditeur et accédez à la section Storefronts > Websites.

Ouvrez le projet dans votre compte et accédez à la section Web Shop.
Dans la section Sites, sélectionnez votre site et cliquez sur Open Site Builder.

Si votre site comporte plusieurs pages, sélectionnez celle qui vous intéresse :
1. Appuyez sur le titre de la page actuelle en haut du constructeur.
2. Sélectionnez la page souhaitée dans la liste déroulante.
Dans la zone principale du constructeur, choisissez l’emplacement où vous souhaitez ajouter un nouveau bloc, puis cliquez sur Add block.
Sélectionnez le bloc Promo codes.
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.

Le texte par défaut du bouton pour utiliser un coupon ou activer un code promo est Redeem. Pour le modifier, appuyez deux fois dessus et entrez le texte à afficher sur le site.

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.

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.

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.

Pour configurer des restrictions régionales pour une campagne, contactez-nous à [email protected].

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.

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.

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 :

Un utilisateur autorisé accède au magasin.
L’utilisateur saisit le code promo.
Xsolla renvoie la liste des bonus disponibles pour le coupon (facultatif).
L’utilisateur sélectionne les bonus (facultatif).
L’utilisateur utilise le coupon.
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.

Configuration dans le Compte éditeur

Vous pouvez également configurer la promotion à l’aide d’un canevas.

Pour créer une nouvelle campagne par coupon :

Ouvrez le projet dans le Compte éditeur et accédez à la section LiveOps > Promotions.
Dans l’onglet Promotions, appuyez sur Create promotion.

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.

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.

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.

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.

Spécifiez la période de validité de la promotion : fuseau horaire, date de début et date de fin. Pour créer une promotion sans date de fin, cochez la case No end date.

Appuyez sur Next.
Révisez les paramètres de la campagne.
Appuyez sur Save and exit.

Pour ajouter des codes de coupon à une campagne :

Ouvrez le projet dans le Compte éditeur et accédez à la section LiveOps > Promotions.
Dans la ligne de la promotion par coupon, appuyez sur ••• et sélectionnez Edit promotion dans la liste déroulante.

Accédez à l’onglet Codes.
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.

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.

Téléchargez un fichier CSV contenant les codes (facultatif).

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 [email protected].

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

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

Configuration via API

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âche	Appel 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,
Configurez des périodes de validité de la promotion.	Créer une promotion ou Mettre à jour une promotion. Passez le champ `promotion_periods` en tant que tableau d’objets où `date_from` définit la date de début et `date_until` la date de fin de la période de validité. Pour qu’une promotion ait une durée indéterminée, indiquez une seule période et passez `“promotion_periods[0].date_until": null`.
Supprimer une promotion.	Supprimer une promotion par coupon.

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 :

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.
Implémentez la logique des coupons à l’aide des appels API côté client suivants :

Pour appeler les endpoints de l’API Xsolla côté client, utilisez les méthodes SDK fournies. Pour en savoir plus, consultez :

Tâche Appel 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.

Tâche	Appel 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.

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.

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.

Assurez-vous que le système attribue correctement les objets à l’utilisateur lors de l’utilisation du coupon.

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.

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

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 :

Ouvrez le projet dans le Compte éditeur et accédez à la section Storefronts > Websites.

Ouvrez le projet dans votre compte et accédez à la section Web Shop.
Dans la section Sites, sélectionnez votre site et cliquez sur Open Site Builder.

Si votre site comporte plusieurs pages, sélectionnez celle qui vous intéresse :
1. Appuyez sur le titre de la page actuelle en haut du constructeur.
2. Sélectionnez la page souhaitée dans la liste déroulante.
Dans la zone principale du constructeur, choisissez l’emplacement où vous souhaitez ajouter un nouveau bloc, puis cliquez sur Add block.
Sélectionnez le bloc Promo codes.
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.

Le texte par défaut du bouton pour utiliser un coupon ou activer un code promo est Redeem. Pour le modifier, appuyez deux fois dessus et entrez le texte à afficher sur le site.

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.

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.

Les promotions par code promo permettent aux utilisateurs d’acheter des articles à prix réduit et de recevoir des objets bonus configurés dans la promotion. Le champ pour entrer un code promo peut être affiché dans le catalogue ou le panier. Un seul code promo peut être appliqué à un achat.

Vous pouvez configurer différents types de promotions pour un article : remises, codes promo et bonus.

Exemple :

Le prix d’un objet virtuel est de 10 $. Dans le Compte éditeur, les promotions suivantes ont été créées pour les objets virtuels :

Promotion par réduction Black Friday avec une remise de 10 % du 4 au 30 novembre
Promotion par réduction Soldes avec une remise de 20 % du 15 novembre au 15 décembre
Promotion avec un code promo pour une remise de 5 % du 4 au 30 novembre

Si l’objet est acheté le 20 novembre, les promotions par réduction et la promotion par code promo sont toutes valides.

Le prix total de l’objet virtuel est ensuite calculé comme suit : ((10 $ - 10 %) - 20 %) - 5 % et sera de 6,84 $.

Créer une nouvelle promotion par code promo

Pour créer une promotion par code promo :

Dans votre projet dans le Compte éditeur, allez dans la section LiveOps > Canvas.

Dans le projet dans votre compte pour les jeux mobiles, allez dans la section Operations > LiveOps.

Commencez à créer une promotion en utilisant l’une des options suivantes :
- Option 1 :

1. 1. Dans la barre d'outils, cliquez sur l’ icône.
  2. Dans la zone de liste des promotions, cliquez sur l'icône +.

1. 1. Sélectionnez promo codes et cliquez sur Create.

- Option 2 : Dans la barre d'outils, cliquez sur l'icône + et sélectionnez Promo codes.

- Option 3 : Ouvrez le menu contextuel n'importe où sur le canvas et sélectionnez Promo codes.

Spécifiez les paramètres de base :
- Nom de la promotion.
- ID externe — un ID unique de promotion utilisé pour gérer les promotions via des appels API.
Définissez quand l'utilisateur peut utiliser un code promo en sélectionnant l'une des options dans le champ Redemption timeframe :
- Avant l'achat — le code promo peut être utilisé sans effectuer d'achat. Dans ce cas, l'utilisateur ne peut recevoir que des objets bonus. Les paramètres de remise ne sont pas disponibles pour cette option.
- À tout moment — le code promo ne peut être utilisé que lors d'un achat. Dans ce cas, l'utilisateur peut recevoir des objets bonus, des remises sur des articles spécifiques et/ou une remise sur l'ensemble du panier.
Ajoutez des objets bonus :
1. Activez la bascule Bonus items.
2. Cliquez sur Select items.
3. Dans la fenêtre qui s'ouvre, cochez les cases à côté des articles requis et spécifiez leur quantité.
4. Cliquez sur Add items.

Pour ajouter une remise à l'ensemble de l'achat (facultatif, indisponible pour le type d'utilisation Avant l'achat) :
1. Activez la bascule Apply discount to entire purchase.
2. Spécifiez le pourcentage de la remise.
Pour ajouter une remise sur des articles spécifiques (facultatif, indisponible pour le type d'utilisation Avant l'achat) :
1. Activez la bascule Apply discount on selected items only.
2. Spécifiez le pourcentage de la remise.
3. Cliquez sur Select items.
4. Dans la fenêtre qui s'ouvre, cochez les cases à côté des articles requis.
5. Cliquez sur Add items.

Cliquez sur Next.
Ajoutez des conditions et des limitations (facultatif) :
1. Pour limiter le nombre total d'utilisations du code promo, activez la bascule Promo code redemptions limit et entrez le nombre requis.
2. Pour limiter le nombre d'utilisations par utilisateur, activez la bascule Promo code redemptions limit per user et entrez le nombre requis.
3. Pour limiter le nombre d'utilisations par code promo unique, activez la bascule Unique promo code redemptions et entrez le nombre requis.
Cliquez sur Next.
Spécifiez la période de la promotion.
Cliquez sur Next.
Vérifiez les paramètres de la promotion.
Pour activer la promotion immédiatement (facultatif), activez la bascule Create in Active status.
Cliquez sur Create.

Pour ajouter la promotion par code promo créée au site (facultatif) :
1. Ouvrez le site dans le builder en cliquant sur Open ou Open in Site Builder sur la bannière dans le formulaire d’édition.
2. Suivez les instructions de la section Configurer l’utilisation des codes promo dans votre application ou site web.

Les promotions par code promo sont créées par défaut à l’état désactivé et ne contiennent aucun code promo pour l’utilisation.

Sur le canvas, des liens visuels sont affichés entre la carte de promotion et les objets de la promotion.

Pour gérer leur affichage, cliquez sur l’icône → ou ← à droite de toute carte d’objet promotionnel, à côté de l’ icône. Si un objet est inclus dans plusieurs promotions, un seul lien peut être affiché à la fois.

Lors de la configuration d’une promotion via le canvas, les options suivantes ne sont pas disponibles :

Configurer une promotion avec des clés de jeu.
Configurer une remise avec des pourcentages fractionnaires.
Configurer une promotion sans date de fin.

Des options avancées pour configurer des promotions par code promo sont disponibles via Compte éditeur et appels API.

Ajouter des codes promo

Pour ajouter des codes promo à la promotion :

Ouvrez la promotion pour l’édition.

Cliquez sur Add promo codes.
Ajoutez le nombre requis de codes promo :
- Pour générer des codes promo automatiquement :
  1. Sélectionnez Auto-generated et spécifiez le nombre de codes promo.
  2. Cliquez sur Generate.
- Pour ajouter un code promo manuellement :
  1. Sélectionnez Manually entered.
  2. Cliquez sur Create.

Les codes promo sont sensibles à la casse. Par exemple, winter2021 et WINTER2021 sont des codes promo différents.

Pour exporter un fichier avec la liste des codes promo (facultatif), cliquez sur Download CSV.

Activer la promotion

Vous pouvez activer la promotion de la manière suivante :

Depuis la carte de la promotion :

Depuis la liste des promotions :

Lors de l’édition de la promotion :

Les promotions actives ne peuvent pas être modifiées. Pour changer les paramètres d’une promotion, désactivez-la d’abord.

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

Utilisation du code promo dans l'interface utilisateur

Dans l’interface utilisateur de l’application (dans le catalogue ou le panier), implémentez les éléments suivants :
- un champ pour la saisie du code promo
- éléments de l’interface utilisateur permettant d’afficher les récompenses et les remises liées aux codes promo
- un formulaire de sélection de récompenses liées aux codes promo (le cas échéant).
- un bouton pour appliquer le code promo
Implémentez la logique du code promo à l’aide des appels API côté client suivants :

Tâche	Appel API
Vérifier si le code promo est valide.	Vérifier un code promotionnel.
Obtenir la liste des plateformes de distribution de jeux à afficher à l’utilisateur lorsqu’une clé de jeu est fournie en bonus via un code promo.	Lire les récompenses d’un code promo. 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 de jeu.
Afficher le catalogue mis à jour en tenant compte des remises et des objets bonus lié à un code promo.	Utilisez les appels de la sous-section Catalog. Vous devez passer le code promo dans le paramètre de requête `promo_code`.
Acheter un objet spécifique directement (sans l’ajouter au panier) et utiliser un code promo.	Créer une commande à partir d’un objet spécifique. Vous devez passer le code promo dans le paramètre de requête `promo_code`.
Appliquer un code promo et mettre à jour le contenu du panier et le coût total (appliquer les remises et ajouter les objets bonus).	Échanger un code promo. Vous devez passer le code promo dans le paramètre de requête `coupon_code`.

Assurez-vous que le système attribue correctement les objets à l’utilisateur lors de l’utilisation du code promo.

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 code promo sont attribués à l'utilisateur de la même façon qu'un achat standard.

Les clés de jeu sont envoyées à l’utilisateur par e-mail ou via le système des droits.

Utilisation de codes promo sur un site web créé avec Xsolla

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 :

Ouvrez le projet dans le Compte éditeur et accédez à la section Storefronts > Websites.

Ouvrez le projet dans votre compte et accédez à la section Web Shop.
Dans la section Sites, sélectionnez votre site et cliquez sur Open Site Builder.

Si votre site comporte plusieurs pages, sélectionnez celle qui vous intéresse :
1. Appuyez sur le titre de la page actuelle en haut du constructeur.
2. Sélectionnez la page souhaitée dans la liste déroulante.
Dans la zone principale du constructeur, choisissez l’emplacement où vous souhaitez ajouter un nouveau bloc, puis cliquez sur Add block.
Sélectionnez le bloc Promo codes.
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.

Le texte par défaut du bouton pour utiliser un coupon ou activer un code promo est Redeem. Pour le modifier, appuyez deux fois dessus et entrez le texte à afficher sur le site.

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.

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.

Merci pour votre commentaire !

Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.

Dernière mise à jour: 24 Août 2026

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

Contenu

Flux utilisateur
Comment configurer
Comment ça marche
Informations générales
Flux utilisateur
Règles d'application des remises
Configurer une campagne avec des codes promo
Configuration dans le Compte éditeur
Configuration via API
Configurez l'utilisation des coupons dans l'application ou sur le site web
Utilisation du code promo dans l'interface utilisateur
Utilisation de codes promo sur un site web créé avec Xsolla
Comment ça marche
Configurez une campagne par coupons
Prérequis
Configuration dans le Compte éditeur
Configuration via API
Configurez l'utilisation des coupons dans l'application ou sur le site web.
Utilisation des coupons dans votre propre interface utilisateur
Utilisation des coupons sur un site web créé avec Xsolla
Créer une nouvelle promotion par code promo
Ajouter des codes promo
Activer la promotion
Configurez l'utilisation des coupons dans l'application ou sur le site web
Utilisation du code promo dans l'interface utilisateur
Utilisation de codes promo sur un site web créé avec Xsolla