Codes promo

Comment ça marche

Les codes promo sont une stratégie marketing utilisée pour attirer de nouveaux utilisateurs et stimuler les ventes. Après avoir activé un code promo, l’utilisateur reçoit l’une des récompenses suivantes :

• une réduction qui s’applique au panier utilisateur ou à des objets spécifiques.
• l’un des objets bonus :
  • clé de jeu ;
  • package de monnaie virtuelle ;
  • objet virtuel, y compris un lot ou des objets à durée limitée.

Principales fonctionnalités :

• choisir uniquement une remise, uniquement un objet bonus ou à la fois une remise et un objet bonus comme récompense ;
• définir le nombre total d’utilisations du code promo dans le cadre de la campagne ;
• définir le nombre d’utilisations du code promo pour un utilisateur spécifique dans le cadre de la campagne ;
• définir des restrictions régionales sur demande ;
• générer des codes promo multiples ;
• ajouter un objet bonus au panier après l’application du code promo ;
• appliquer une remise aux objets après l’utilisation d’un code promo.

Limites :

• un seul code promo peut être appliqué au panier ;
• pour obtenir une remise ou un bonus, l’utilisateur doit payer les objets dans le 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 d’objets en utilisant ce code promo.

Comment ça marche

Flux utilisateur :

1. L’utilisateur saisit le code promo dans le champ correspondant de l’interface.

2. Le coût des objets est recalculé, des objets bonus sont ajoutés.
3. L'utilisateur procède au paiement, après quoi le code promo est considéré comme échangé.
4. Si le code promo comprenait des objets bonus, ceux-ci sont livrés à l'utilisateur de l'une des manières suivantes :
• directement dans l'inventaire (objet virtuel ou package de monnaie virtuelle) ;
• par e-mail (clé de jeu) ;
• directement dans le système de droits (clé de jeu).

• le résultat de l’application de la promotion par réduction :
  • montant de la remise pour la promotion ;
  • prix barré sans remise ;
  • prix réduit.
• le résultat de l’application de la promotion par bonus :
  • objets bonus ;
  • valeur Free dans la ligne de prix pour les objets bonus.
• le résultat de l’application du code promo :
  • montant de la remise pour le code promo ;
  • prix barré sans remise ;
  • prix réduit ;
  • objets bonus ;
  • valeur Free dans la ligne de prix pour les objets bonus.

Comment configurer

Prérequis

1. Créez votre Compte éditeur Xsolla.
2. Connectez le module Game Keys et configurez-le.

Flux d'intégration

• Configurez une campagne promotionnelle avec des codes promo.
• Implémentez la méthode pour obtenir la récompense associée à un code promo.
• Implémentez les méthodes pour échanger des codes promo.

Si vous implémentez l’achat rapide d’une clé à l’aide de la méthode Create order with specified item, l’utilisateur procède au paiement directement sans passer par l’ajout au panier.

En parallèle, un panier est créé côté Xsolla, mais n’est pas affiché à l’utilisateur. Cela est nécessaire pour appliquer correctement toutes les réductions existantes à l’achat de l’utilisateur et afficher le montant final dans le formulaire de paiement.

Configurer une campagne avec des codes promo

1. Accédez à Store > Promotions and rewards dans le Compte éditeur et créez une promotion.
2. Spécifiez les paramètres suivants :
1. Saisissez le nom de la promotion ;
2. Choisissez Promo codes 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 de réception de récompenses et d'utilisation de code promo.
4. Spécifiez le pourcentage de remise pour le code promo. La remise peut être appliquée à l'intégralité du panier ou à des objets spécifiques.
5. 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.
6. Spécifiez le nombre total d'utilisations et le nombre d'utilisations par utilisateur.
7. Spécifiez la durée de la campagne.
8. Vérifiez les paramètres et enregistrez la promotion.
9. Accédez au menu d'édition de la promotion.
10. Dans l'onglet Codes, choisissez le mode de génération des codes promo.
11. Générez le code promo ou saisissez-le manuellement.
12. Enregistrez les modifications.
13. 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.

Pour créer un package de monnaie virtuelle :

1. Accédez aux paramètres du module Store > Virtual Currency et créez une monnaie virtuelle. Pour ce faire, cliquez sur New virtual currency et ajoutez :
   • image du package (facultatif) ;
   • UGS de la monnaie virtuelle ;
   • nom de la monnaie virtuelle ;
   • prix d’une unité de monnaie virtuelle ;
   • monnaie par défaut ;
   • attribut (facultatif).
2. Créez les packages de monnaie virtuelle. Pour ce faire, cliquez sur New Package et ajoutez :
   • image du package (facultatif) ;
   • UGS du package ;
   • nom du package ;
   • brève description du package ;
   • monnaie virtuelle dans le package ;
   • quantité de la monnaie dans le package ;
   • prix en devises réelles et/ou en monnaie virtuelle ;
   • monnaie par défaut ;
   • attribut (facultatif).
3. Cliquez sur Create package.

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.

Pour créer des objets virtuels :

1. Accédez à Store > Virtual Items et cliquez sur Create Item.
2. Pour chaque objet, ajoutez :
   • image (facultatif) ;
   • UGS ;
   • un ou plusieurs groupes auxquels l’objet doit appartenir (facultatif) ;
   • nom de l’objet ;
   • description de l’objet ;
   • propriétés de l’objet : objet consommable, non consommable ou à durée limitée ;
   • prix en devises réelles et/ou en monnaie virtuelle.
3. Cliquez sur Create item.

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.

Générer des codes promo

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

Restrictions régionales

Obtenir la récompense associée au code promo

1. Si is_selectable=true, pour chaque élément item avec type=unit, vous devez afficher un formulaire permettant à l’utilisateur de choisir des éléments parmi ceux disponibles dans l’objet unit_items. Dans ce formulaire, l’utilisateur choisit un seul élément pour chaque type unit.

{
	"bonus": [{
		"item": {
			"sku": "xsollus_gold_edition",
			"name": "Xsollus: Gold Edition",
			"type": "unit",
			"description": null,
			"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
			"unit_items": [{
				"sku": "xsollus_gold_edition_steam",
				"name": "Xsollus: Gold Edition (steam)",
				"type": "game_key",
				"drm_name": "Steam",
				"drm_sku": "steam"
			}, {
				"sku": "xsollus_gold_edition_playstation",
				"name": "Xsollus: Gold Edition (playstation)",
				"type": "game_key",
				"drm_name": "Playstation",
				"drm_sku": "playstation"
			}, {
				"sku": "xsollus_gold_edition_xbox",
				"name": "Xsollus: Gold Edition (xbox)",
				"type": "game_key",
				"drm_name": "XBox",
				"drm_sku": "xbox"
			}, {
				"sku": "xsollus_gold_edition_nintendo_eshop",
				"name": "Xsollus: Gold Edition (nintendo_eshop)",
				"type": "game_key",
				"drm_name": "Nintendo Switch eShop",
				"drm_sku": "nintendo_eshop"
			}]
		},
		"quantity": 1
	}, {
		"item": {
			"sku": "xsollus_bonus_pack_edition",
			"name": "Xsollus: Bonus Pack",
			"type": "unit",
			"description": null,
			"image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
			"unit_items": [{
				"sku": "xsollus_bonus_pack_edition_steam",
				"name": "Xsollus: Bonus Pack (steam)",
				"type": "game_key",
				"drm_name": "Steam",
				"drm_sku": "steam"
			}, {
				"sku": "xsollus_bonus_pack_edition_origin",
				"name": "Xsollus: Bonus Pack (origin)",
				"type": "game_key",
				"drm_name": "Origin",
				"drm_sku": "origin"
			}, {
				"sku": "xsollus_bonus_pack_edition_drmfree",
				"name": "Xsollus: Bonus Pack (drmfree)",
				"type": "game_key",
				"drm_name": "DRM Free",
				"drm_sku": "drmfree"
			}, {
				"sku": "xsollus_bonus_pack_edition_gog",
				"name": "Xsollus: Bonus Pack (gog)",
				"type": "game_key",
				"drm_name": "GOG",
				"drm_sku": "gog"
			}, {
				"sku": "xsollus_bonus_pack_edition_rockstar",
				"name": "Xsollus: Bonus Pack (rockstar)",
				"type": "game_key",
				"drm_name": "Rockstar Games Launcher",
				"drm_sku": "rockstar"
			}]
		},
		"quantity": 3
	}],
	"discount": {
		"percent": null
	},
	"is_selectable": true

2. Si is_selectable=false, vous ne devez pas passer de paramètres supplémentaires dans la requête.

Échanger un code promo

1. Si is_selectable=true, passez l’objet selected_unit_items dans le format suivant lors de l’appel à la méthode Redeem promo code :

selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

Exemple de réponse :

{
  {
    "items": [
    {
      "sku": "xsollus_gold_edition_steam",
      "name": "Xsollus: Gold Edition (steam)",
      "type": "game_key",
      "description": null,
      "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/9541470622d96a821a9a11ea7763ea4c.png",
      "attributes": [],
      "is_free": true,
      "groups": [],
      "price": null,
      "virtual_prices": [],
      "drm_name": "Steam",
      "drm_sku": "steam",
      "has_keys": false,
      "is_pre_order": true,
      "release_date": null,
      "quantity": 1
    },
    {
      "sku": "xsollus_bonus_pack_edition_origin",
      "name": "Xsollus: Bonus Pack (origin)",
      "type": "game_key",
      "description": null,
      "image_url": "https:\/\/cdn3.xsolla.com\/img\/misc\/images\/aa2efd78dfd4e5dda5293f8c8e49af6d.png",
      "attributes": [],
      "is_free": true,
      "groups": [],
      "price": null,
      "virtual_prices": [],
      "drm_name": "Origin",
      "drm_sku": "origin",
      "has_keys": false,
      "is_pre_order": true,
      "release_date": null,
      "quantity": 3
    }
    ]
}

2. Si is_selectable=false, vous ne devez pas passer de paramètres supplémentaires dans la requête.