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.

Note
Vous pouvez également ajouter des promotions par code promo à votre Store.
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.
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 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

Note
Pour échanger le coupon et recevoir les objets bonus, l’utilisateur doit être autorisé.
  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 Vérifier un code promotionnel pour valider le code de coupon saisi.
  3. 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

  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 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 :

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.

Note
Les nouvelles promotions sont inactives par défaut. Pour activer votre promotion, accédez à la section d’édition, et dans le coin supérieur droit de la liste déroulante, sélectionnez Activate promotion.
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 and rewards, cliquez sur :
    • Connect — si vous n’avez pas de promotions connectées ;
    • Configure — si vous avez déjà connecté de promotions.
  1. Cliquez sur Create promotion.
  1. 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 :
  1. Spécifiez le nombre total d'utilisations et le nombre d'utilisations par utilisateur.
  1. Définissez les dates de début et de fin de la campagne.
  1. Vérifiez les paramètres et enregistrez la promotion.
  1. Accédez au menu d'édition de la promotion.
  2. Dans le menu Codes, choisissez la méthode de génération de coupons.
  3. Générez le code de coupon ou saisissez-le manuellement.
  4. Enregistrez les modifications.
  5. 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.
Note
Le code de coupon distingue les majuscules et les minuscules. Par exemple, 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âcheMéthode API
Créer une promotion avec couponCréer une promotion par coupon
Activer la promotion avec couponActiver une promotion par coupon
Éditer une promotionMettre à 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 promotionDésactiver une promotion par coupon
Configurer une promotion à durée indéterminéeCré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.
Vérification et application du code de coupon :
TâcheMéthode API
Vérifier si le coupon est correctVé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 couponGet coupon rewards
Gestion des limites :
TâcheMéthode API
Récupérer le nombre d’utilisations restantes d’un coupon pour un utilisateur spécifiqueLire la limite de coupon pour un utilisateur spécifique
Augmenter le nombre d’utilisations restantes d’un coupon pour un utilisateur spécifiqueAugmenter la limite de coupon pour un utilisateur spécifique
Définir une nouvelle limite d’utilisation d’un coupon pour un utilisateur spécifiqueDéfinir la limite de coupon pour un utilisateur spécifique
Diminuer le nombre d’utilisations restantes d’un coupon pour un utilisateur spécifiqueRéduire la limite de coupon pour un utilisateur spécifique
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: 3 Octobre 2024

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Enté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 !