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.

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 Vérifier un code promotionnel ou Redeem promo code. L’utilisateur ne pourra obtenir aucun des objets associés au code promo.

Flux d'intégration

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

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.

3. Cliquez sur Create promotion.

4. Spécifiez les paramètres suivants :
   • Saisissez le nom de la promotion.
   • Choisissez Promo codes comme type de promotion.
5. Créez un External ID — un identifiant de promotion unique utilisé pour gérer les promotions via les méthodes API.
6. 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.
7. 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.

8. Spécifiez le nombre total d'utilisations et le nombre d'utilisations par utilisateur.

9. Spécifiez la durée de la campagne.

10. Vérifiez les paramètres et enregistrez la promotion.
11. Accédez au menu d'édition de la promotion.
12. Dans l'onglet Codes, choisissez la méthode de génération de codes promo.
13. Générez le code promo ou saisissez-le manuellement.
14. Enregistrez les modifications.
15. 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.

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 :

Vérification et application du code promo :Gestion des limites :

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.

Dernière mise à jour: 3 Octobre 2024