Codes promo
Comment ça marche
Les promotions par code promo permettent aux utilisateurs d’acheter des objets à des prix réduits et de recevoir des objets bonus selon les paramètres de la campagne. Le champ de saisie du code promo peut être affiché dans le catalogue ou dans le panier.
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 remise qui s’applique à l’ensemble de l’achat ou à des objets spécifiques ;
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 :
- octroi en guise de récompense pour un code promo soit une remise, soit un objet bonus, ou les deux ;
- limitation du nombre total d’utilisations du code promo dans le cadre de la campagne ;
- limitation du nombre d’utilisations du code promo par un utilisateur dans le cadre de la campagne ;
- génération de plusieurs codes promo ;
- définition de restrictions régionales sur demande ;
- ajout d’un objet bonus au panier après l’application du code promo ;
- application d’une remise sur les objets après l’utilisation du code promo.
Restrictions :
- un seul code promo peut être appliqué au panier ;
- pour obtenir une réduction ou un bonus, l’utilisateur doit procéder au paiement des objets du panier ;
- si un code promo 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 code promo. 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 promo, une erreur sera renvoyée en réponse aux méthodes Vérifier un code promotionnel ou Échanger un code promo. L’utilisateur ne pourra obtenir aucun des objets associés au code promo.
Flux d'intégration
Les scénarios décrits ci-dessous s’appliquent à un utilisateur autorisé.
Pour les utilisateurs non autorisés, le nombre maximum de fois qu’une promotion peut être utilisée est toujours affiché. Pour afficher à l’utilisateur le nombre restant de fois que la promotion peut être utilisée (sous réserve de la limite courante), passez les données d’autorisation de l’utilisateur lors de la requête de catalogue des objets à l’aide des méthodes de la sous-section Catalogue du groupe de méthodes Objets et monnaie virtuels.
Vous pouvez configurer différents types de promotions pour un objet : réductions, coupons, codes promo et bonus.
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.
Par 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 Vente avec une remise de 20 % du 15 novembre au 15 décembre ;
- promotion avec 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 avec 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 $.
Comment configurer
Prérequis
- Enregistrez un Compte éditeur.
- Connectez Store et configurez les modules Virtual Items et Virtual Currency.
Configurer une promotion avec code promo
Vous pouvez configurer des promotions par code promo :
- 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 promo et échanger le code promo.
Configuration dans le Compte éditeur
Si vous configurez des promotions par code promo 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 code promo dont le statut est Active n’est actuellement pas disponible dans le Compte éditeur.
Pour accéder aux options avancées de configuration de vos promotions par code promo, utilisez les méthodes API.
- Ouvrez votre projet dans le Compte éditeur.
- Dans le menu latéral, cliquez sur Store et accédez à la section Promotions and rewards.
- Cliquez sur Create promotion.
- Spécifiez les paramètres suivants :
- Saisissez le nom de la promotion.
- Choisissez Promo codes 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.
- Spécifiez le pourcentage de remise pour le code promo. La remise peut être appliquée à l'intégralité de l'achat ou à des objets spécifiques.
- Choisissez les objets bonus que l'utilisateur reçoit lorsqu'il utilise un code promo :
- aucune récompense ;
- package de monnaie virtuelle ;
- objet virtuel (un ou plusieurs, y compris les lots et les objets à durée limitée) ;
- clé de jeu.
- Spécifiez le nombre total d'utilisations et le nombre d'utilisations par utilisateur.
- Spécifiez la durée de la campagne.
- Vérifiez les paramètres et enregistrez la promotion.
- Accédez au menu d'édition de la promotion.
- Dans l'onglet Codes, choisissez la méthode de génération de codes promo.
- Générez le code promo ou saisissez-le manuellement.
- Enregistrez les modifications.
- Activez la promotion.
Code promo avec package de monnaie virtuelle
Pour créer un code promo avec package de monnaie virtuelle :- Créez un package de monnaie virtuelle.
- Spécifiez un package de monnaie virtuelle comme objet bonus.
Code promo avec objet virtuel
Pour créer un code promo avec objet virtuel :
- Créez un objet virtuel.
- Spécifiez un objet virtuel comme objet bonus.
Un code promo peut contenir un ou plusieurs objets avec différentes UGS, y compris des lots et des objets à durée limitée.
Code promo avec clé de jeu
Pour créer un code promo avec clé de jeu :- Créez un package de clés de jeu.
Spécifiez l’UGS du package de clés de jeu créé comme objet bonus et la méthode de sélection de la plateforme pour laquelle le jeu est acheté :
- Le code promo est généré pour la plateforme spécifique déjà définie ;
- L’utilisateur sélectionne la plateforme spécifique lors de l’utilisation des codes promo.
Générer des codes promo
Une campagne peut inclure un ou plusieurs codes promo. Le format du code promo offre deux options :- Chaîne saisie manuellement — adaptée à une campagne comportant un seul code promo 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 codes promo.
winter2021
et WINTER2021
sont 2 codes promo 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 code promo, utilisez les méthodes de la sous-section Codes promo du groupe de méthodes Promotions.
Configuration de promotion :
Tâche | Méthode 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 |
Éditer 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 |
Configurer une promotion à durée indéterminée | Créer une promotion par code promo ou Mettre à jour une promotion par code promo. Passez le paramètre “date_end”:null à la méthode spécifiée. |
Tâche | Méthode API |
---|---|
Vérifier si le code promo est correct | Vérifier un code promotionnel |
Échanger un code promo | Échanger un code promo |
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 code promo | Lire les récompenses d’un code promo |
Tâche | Méthode API |
---|---|
Récupérer le nombre d’utilisations restantes d’un code promo pour un utilisateur spécifique | Lire la limite de code promo pour un utilisateur spécifique |
Augmenter le nombre d’utilisations restantes d’un code promo pour un utilisateur spécifique | Augmenter la limite de code promo pour un utilisateur spécifique |
Définir une nouvelle limite d’utilisation d’un code promo pour un utilisateur spécifique | Définir la limite de code promo pour un utilisateur spécifique |
Diminuer le nombre d’utilisations restantes d’un code promo pour un utilisateur spécifique | Réduire la limite de code promo pour un utilisateur spécifique |
Si le champ de saisie du code promo est placé dans le catalogue, après avoir saisi le code promo, réalisez à nouveau une requête de catalogue des objets pour l’afficher à l’utilisateur. Ce faisant, passez le code promo dans le paramètre promo_code
dans les méthodes de la sous-section Catalog pour la construction du catalogue.
Si vous implémentez l’achat rapide d’un objet à l’aide de la méthode Créer une commande à partir d’un objet spécifique, passez les données du code promo dans le paramètre promo_code
. Cela permet de réaliser l’achat en appliquant le code promo.
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.