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.
La principale différence est que les codes promo sont utilisés lors d’un achat, tandis que les coupons sont échangés indépendamment, sans obligation d’achat.
- 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 Vérifier un code promotionnel ou Échanger un code de coupon. L’utilisateur ne pourra obtenir aucun des objets associés au coupon.
Flux d'intégration
- Dans votre magasin, implémentez l'affichage d'un champ où l'utilisateur peut entrer le code de coupon.
- Utilisez la méthode Vérifier un code promotionnel pour valider le code de coupon saisi.
- Utilisez la méthode Échanger un code de coupon 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
- Enregistrez un Compte éditeur.
- 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.
- Ouvrez votre projet dans le Compte éditeur.
- Dans le menu latéral, cliquez sur Store.
- Dans le panneau Promotions and rewards, cliquez sur :
- Connect — si vous n’avez pas de promotions connectées ;
- Configure — si vous avez déjà connecté de promotions.
- Cliquez sur Create promotion.
- Spécifiez les paramètres suivants :
- Saisissez le nom de la promotion.
- Choisissez Coupon comme type de promotion.
- Créez un External ID — un identifiant de promotion unique utilisé pour gérer les promotions via les méthodes API.
- 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).
- Spécifiez le nombre total d'utilisations et le nombre d'utilisations par utilisateur.
- Définissez les dates de début et de fin de la campagne.
- Vérifiez les paramètres et enregistrez la promotion.
- Accédez au menu d'édition de la promotion.
- Dans le menu Codes, choisissez la méthode de génération de coupons.
- Générez le code de coupon ou saisissez-le manuellement.
- Enregistrez les modifications.
- 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 :- 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.
- 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.
- 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 :- Chaîne saisie manuellement — adaptée à une campagne comportant un seul coupon pouvant être utilisé plusieurs fois (128 caractères au maximum).
- Chaîne générée — ligne de chiffres et de symboles latins (10 caractères). Convient aux campagnes avec de nombreux coupons.
winter2021
et WINTER2021
sont 2 coupons différents.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 :
Tâche | Méthode API |
---|---|
Créer une promotion avec coupon | Créer une promotion par coupon |
Activer la promotion avec coupon | Activer une promotion par coupon |
Éditer une promotion | Mettre à jour une promotion par coupon : 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 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 à la méthode spécifiée. |
Tâche | Méthode API |
---|---|
Vérifier si le coupon est correct | Vérifier un code promotionnel |
Échanger un coupon | Échanger un code de coupon |
Récupérer une liste de plateformes de distribution de jeux à afficher à l’utilisateur si une clé de jeu est offerte en bonus pour un coupon | Get coupon rewards |
Tâche | Méthode API |
---|---|
Récupérer le nombre d’utilisations restantes d’un coupon pour un utilisateur spécifique | Lire la limite de coupon pour un utilisateur spécifique |
Augmenter le nombre d’utilisations restantes d’un coupon pour un utilisateur spécifique | Augmenter la limite de coupon pour un utilisateur spécifique |
Définir une nouvelle limite d’utilisation d’un coupon pour un utilisateur spécifique | Définir la limite de coupon pour un utilisateur spécifique |
Diminuer le nombre d’utilisations restantes d’un coupon pour un utilisateur spécifique | Réduire la limite de coupon pour un utilisateur spécifique |
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.