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.

Note
Vous pouvez également ajouter des promotions par coupon à 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.
Après l’activation d’un code promo, l’utilisateur peut recevoir :
  • 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 Verify promotion code ou Redeem promo code. L’utilisateur ne pourra obtenir aucun des objets associés au code promo.

Flux d'intégration

Note

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 Catalog du groupe de méthodes Virtual Items & Currency.

Avis

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

  1. Enregistrez un Compte éditeur.
  2. 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 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 :

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.

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 et accédez à la section Promotions and rewards.
  1. Cliquez sur Create promotion.
  1. Spécifiez les paramètres suivants :
    • Saisissez le nom de la promotion.
    • Choisissez Promo codes comme type de promotion.
  2. Créez un External ID — un identifiant de promotion unique utilisé pour gérer les promotions via les méthodes API.
  3. 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.
  4. Choisissez les objets bonus que l'utilisateur reçoit lorsqu'il utilise un code promo :
  1. Spécifiez le nombre total d'utilisations et le nombre d'utilisations par utilisateur.
  1. Spécifiez la durée de la campagne.
  1. Vérifiez les paramètres et enregistrez la promotion.
  2. Accédez au menu d'édition de la promotion.
  3. Dans l'onglet Codes, choisissez la méthode de génération de codes promo.
  4. Générez le code promo ou saisissez-le manuellement.
  5. Enregistrez les modifications.
  6. Activez la promotion.

Code promo avec package de monnaie virtuelle

Pour créer un code promo avec package de monnaie virtuelle :
  1. Créez un package de monnaie virtuelle.
  2. Spécifiez un package de monnaie virtuelle comme objet bonus.

Code promo avec objet virtuel

Pour créer un code promo avec objet virtuel :

  1. Créez un objet virtuel.
  2. 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 :
  1. Créez un package de clés de jeu.
  2. 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.

Un seul code promo peut contenir plusieurs clés avec des UGS différentes.

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.
Pour générer des codes promo, utilisez l’éditeur de promotion après avoir créé une promotion par code promo. Vous pouvez générer un code promo à plusieurs reprises. Le téléchargement des codes saisis manuellement est effectué sur demande par e-mail à Xsolla.
Note
Le code promo distingue les majuscules et les minuscules. Par exemple, 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 Promo Codes du groupe de méthodes Promotions.

Configuration de promotion :

TâcheMéthode API
Créer une promotion avec code promoCreate promo code promotion
Activer une promotion avec code promoActivate promo code promotion
Éditer une promotionUpdate promo code promotion : définir de nouvelles options de promotion. L’édition des promotions est également disponible pour les promotions avec le statut Active.
Désactiver une promotionDeactivate promo code promotion
Configurer une promotion à durée indéterminéeCreate promo code promotion ou Update promo code promotion. Passez le paramètre “date_end”:null à la méthode spécifiée.
Vérification et application du code promo :
TâcheMéthode API
Vérifier si le code promo est correctVerify promotion code
Échanger un code promoRedeem promo code
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 promoGet promo code rewards
Gestion des limites :
TâcheMéthode API
Récupérer le nombre d’utilisations restantes d’un code promo pour un utilisateur spécifiqueGet promo code limit for specified user
Augmenter le nombre d’utilisations restantes d’un code promo pour un utilisateur spécifiqueIncrease promo code limit for specified user
Définir une nouvelle limite d’utilisation d’un code promo pour un utilisateur spécifiqueSet promo code limit for specified user
Diminuer le nombre d’utilisations restantes d’un code promo pour un utilisateur spécifiqueDecrease promo code limit for specified user

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 Create order with specified item, 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.

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 !