Coupons

Comment ça marche

Les promotions par coupon sont une stratégie marketing efficace pour attirer de nouveaux utilisateurs et stimuler les ventes. Lorsqu’un joueur utilise un coupon, il reçoit une récompense spécifique associée à ce coupon. Les récompenses peuvent inclure :

• un package de monnaie virtuelle ;
• une clé de jeu ;
• un objet virtuel.

Chaque coupon possède un code. Pour utiliser un coupon, l’utilisateur saisit le code dans le jeu, sur le site Web ou dans l’application mobile.

Caractéristiques principales :

• Définir le nombre total de coupons pouvant être échangés lors d’une campagne.
• Définir le nombre de coupons qu’un utilisateur peut échanger au cours d’une campagne.
• Générer des codes de coupon à plusieurs reprises.
• Appliquer des restrictions régionales de vente sur les promotions et les objets associés à un coupon.

Restrictions :

• Si vous associez des clés de jeu à un coupon, l’une d’entre elles sera envoyée par e-mail au joueur qui utilisera le coupon. S’il ne reste aucune clé dans la campagne, la demande du joueur d’utiliser un coupon sera refusée.
• Si le coupon est lié à une promotion avec des restrictions régionales, les utilisateurs d’une région soumise à des restrictions ne pourront pas l’utiliser.
• Si le coupon est lié à un objet avec des restrictions régionales de vente, les utilisateurs d’une région soumise à des restrictions ne pourront pas obtenir cet objet lié à ce coupon.

Flux utilisateur :

1. Un utilisateur utilise un coupon.
2. La récompense associée au coupon est envoyée à 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 au système de droits d’accès (clé de jeu).

Comment configurer

Prérequis

1. Créez votre Compte éditeur Xsolla.
2. Connectez Store à votre projet.

Flux d'intégration

1. Configurez une campagne promotionnelle avec des coupons.
2. Utilisez les méthodes pour obtenir la récompense associée à un coupon.
3. Utilisez les méthodes pour échanger un coupon par code.

Configurer une campagne avec des coupons

1. Accédez à la section Store > Promotions and rewards dans le Compte éditeur et créez une promotion.
2. Spécifiez les paramètres nécessaires :
   1. Entrez le titre de la promotion.
   2. Sélectionnez Coupons comme type de promotion.
3. Choisissez le l'objet bonus que l'utilisateur reçoit lorsqu'il utilise un coupon :
   1. Package de monnaie virtuelle ;
   2. Clé de jeu ;
   3. Objet virtuel (un ou plusieurs, y compris les lots et les objets à durée limitée).
4. Spécifiez le nombre total d'utilisations et le nombre d'utilisations par utilisateur.
5. Spécifiez les dates de début et de fin de la campagne.
6. Vérifiez les paramètres et enregistrez la promotion.
7. Accédez au menu d'édition des promotions.
8. Dans le menu Codes, choisissez la méthode de génération des coupons.
9. Générez le code de coupon ou saisissez-le manuellement.
10. Enregistrez les modifications.
11. Activez la promotion.

Coupon avec package de monnaie virtuelle

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

• 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

Génération des coupons

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.

Restrictions régionales

Obtention de la récompense associée au coupon

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_rockstar",
				"name": "Xsollus: Gold Edition (rockstar)",
				"type": "game_key",
				"drm_name": "Rockstar Games Launcher",
				"drm_sku": "rockstar"
			}]
		},
		"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_playstation",
				"name": "Xsollus: Bonus Pack (playstation)",
				"type": "game_key",
				"drm_name": "Playstation",
				"drm_sku": "playstation"
			}, {
				"sku": "xsollus_bonus_pack_edition_xbox",
				"name": "Xsollus: Bonus Pack (xbox)",
				"type": "game_key",
				"drm_name": "XBox",
				"drm_sku": "xbox"

			}]
		},
		"quantity": 3
	}],
	"is_selectable": true

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

Échange d'un coupon par code

1. Si is_selectable=true, vous devez passer l’objet selected_unit_items dans le format suivant lors de l’appel à la méthode Redeem coupon 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.