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.
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.
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 :
- 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 :
- Spécifiez Promotion name.
- Dans la liste déroulante Promotion type, sélectionnez Coupon.
- Dans le champ External ID, indiquez un ID de promotion utilisé pour gérer les promotions par appels API.
- Dans la liste déroulante Select bonus items, choisissez le type d'objet à attribuer à l'utilisateur lors de l'utilisation du coupon.
- Sélectionnez les objets à attribuer à l'utilisateur lors de l'utilisation du coupon.
- Pour les objets virtuels, précisez la quantité pour chaque objet.
- 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.
- Pour les clés de jeu, précisez quand la plateforme sera déterminée :
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.
- Appuyez sur Next.
- Configurez les limites d’utilisation des coupons :
- 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.
- 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.
- 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.
- Appuyez sur Next.
- 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.
- 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 :
- Dans la liste déroulante Code string format, sélectionnez Auto-generated.
- Indiquez le nombre de codes à générer, puis cliquez sur Generate.
- Pour ajouter des codes manuellement :
- Dans la liste déroulante Code string format, sélectionnez Manually entered.
- Entrez le code de coupon et appuyez sur Create.
- 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 igs@xsolla.com.
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, |
| 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. |
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 :
| 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 Le paramètre |
- 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.
Utilisation des coupons sur un site web créé avec Xsolla
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.
- Dans la section Sites, sélectionnez votre site et cliquez sur Open Site Builder.
- Dans la zone principale de l’éditeur, 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.
- Pour appliquer les modifications, publiez le site web :
- Dans le coin supérieur droit du constructeur, appuyez sur Publish.
- Cochez les cases à côté des pages que vous souhaitez publier.
- 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.
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entrée.