Configurer des campagnes promotionnelles

Après l’intégration du magasin dans le jeu, configurez les coupons, les codes promo, les bonus ou les promotions pour attirer de nouveaux utilisateurs et stimuler les ventes.

Il est possible d’organiser des promotions personnalisées, c’est-à-dire de configurer des campagnes pour des utilisateurs spécifiques. Vous pouvez définir le nombre d’objets disponibles pour ces utilisateurs dans le cadre de la promotion. Toutefois, l’option n’est applicable qu’aux campagnes promotionnelles avec des réductions et avec des bonus.

Avis
Le catalogue personnalisé ne peut être utilisé qu’avec le produit Login.

Si vous avez déjà intégré le produit Login, procédez comme suit avant de configurer des promotions personnalisées pour certains utilisateurs :

  1. Configurez les attributs utilisateur pour votre projet.
  2. Définissez le schéma des attributs utilisateurs dans la section Login.

Les attributs sont des caractéristiques de l’utilisateur qui sont stockées sous forme de paires clé-valeur. À l’aide des attributs, vous pouvez :

  • segmenter les utilisateurs ;
  • préparer des vitrines personnalisées pour chaque groupe d’utilisateurs dans votre Web Shop.

Pour garantir l’intégrité des données passées, définissez des règles de validation des attributs au format JSON Schema dans le Compte éditeur, et gérez les attributs utilisateurs à l’aide des méthodes Login API ou des webhooks. Vous pouvez également modifier les valeurs des attributs dans le Compte éditeur. Pour plus d’informations, reportez-vous à Comment configurer les attributs utilisateur.

Les coupons comportent des codes qui permettent d’obtenir des objets gratuits sans achat ni panier. Pour utiliser un coupon, l’utilisateur doit saisir le code dans le jeu, le site Web ou l’application mobile. La récompense associée est alors ajoutée à l’inventaire de l’utilisateur. Les récompenses peuvent inclure :

Voir la section Coupons pour plus d’informations sur les coupons.

Les codes promo permettent d’appliquer une réduction au panier ou d’ajouter des objets gratuits au panier au moment du paiement. Après l’activation d’un code promo et le paiement des objets du panier, l’utilisateur peut recevoir l’une des récompenses suivantes :

Voir la section Codes promo pour plus d’informations sur les codes promo.

L’utilisateur peut également recevoir un bonus lorsqu’il achète des objets promotionnels. Les bonus peuvent comprendre :

Une promotion par réduction permet de configurer une remise sur un ou plusieurs biens. Un nombre illimité de promotions peut être appliqué à un bien. Les remises ne sont pas cumulatives, mais s’appliquent au coût de chaque bien. Les remises peuvent s’appliquer à un ou plusieurs des biens suivants :

Voir la section Promotions par réduction pour plus d’informations sur les remises.

Avis
Dans les campagnes avec remises, codes promo ou coupons, seuls les packages de monnaie virtuelle sont utilisés. La monnaie virtuelle en quantité arbitraire est réservée aux campagnes avec bonus.

Campagne promotionnelle avec des coupons

Pour lancer une campagne promotionnelle avec des coupons :

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

Note
Les restrictions régionales s’appliquent à l’ensemble de la campagne promotionnelle. Pour appliquer les restrictions régionales, envoyez un e-mail à Xsolla.

Configurer une campagne promotionnelle avec des coupons

  1. Ouvrez votre projet dans le Compte éditeur.
  2. Dans le menu latéral, cliquez sur Store, puis sur Promotions and rewards.
  1. Cliquez sur Create promotion.
  1. Spécifiez les paramètres suivants :
    1. Entrez le titre de la promotion ;
    2. Choisissez Coupons comme type de promotion.
  2. Choisissez la récompense que l'utilisateur reçoit lorsqu'il échange un coupon. Options disponibles :
  3. Ajoutez :
    1. Identifiant promotionnel dans External ID ;
    2. Objets bonus que l'utilisateur reçoit lorsqu'il échange un coupon ;
    3. Type et quantité de l'objet.
  4. Cliquez sur Next.
  1. Spécifiez le nombre total d'utilisations et le nombre d'utilisations par utilisateur.
  1. Définissez les dates de début et de fin de la promotion.
  2. Cliquez sur Next.

  1. Vérifiez les paramètres et cliquez sur Save and exit.

Note
Tant qu’une promotion est active, vous ne pouvez pas la modifier.

  1. Dans le menu latéral, cliquez sur Store, puis sur Promotions and rewards.
  2. Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit promotion.

  1. Accédez à l'onglet Codes.
  2. Spécifiez comment les coupons sont générés.
  1. Générez le code de coupon ou saisissez-le manuellement.
  2. Activez la promotion.

Échange d'un coupon par code

Note
Pour appeler les API de Xsolla, vous pouvez utiliser les méthodes SDK prêtes à l’emploi pour les moteurs de jeu et les plateformes :

Implémentez la méthode Redeem coupon code pour utiliser un coupon. Selon la valeur du paramètre is_selectable dans la réponse de l’appel à la méthode Get coupon rewards, deux flux sont possibles :

  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 :

Copy
Full screen
Small screen
selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

Exemple de réponse :

Copy
Full screen
Small screen
{
  {
    "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
  }
  ]
}
  1. Si is_selectable=false, vous ne devez pas passer de paramètres supplémentaires dans la requête.

Obtention de la récompense associée au coupon

Note
Pour appeler les API de Xsolla, vous pouvez utiliser les méthodes SDK prêtes à l’emploi pour les moteurs de jeu et les plateformes :

Appelez la méthode Get coupon rewards pour obtenir la liste des objets que l’utilisateur reçoit après avoir échangé un coupon. Selon la valeur du paramètre is_selectable dans la réponse, deux flux sont possibles :

  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.
Voici un exemple de réponse :

Copy
Full screen
Small screen
{
	"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
  1. Si is_selectable=false, vous ne devez pas passer de paramètres supplémentaires dans la requête.

Campagne promotionnelle avec des codes promo

Pour lancer une campagne promotionnelle avec des codes promo :

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

Configurer une campagne promotionnelle avec des codes promo

  1. Ouvrez votre projet dans le Compte éditeur.
  2. Dans le menu latéral, cliquez sur Store, puis sur Promotions and rewards.

  1. Cliquez sur Create promotion.

  1. Spécifiez les paramètres suivants :
    1. Entrez le titre de la promotion.
    2. Choisissez Promo code comme type de promotion.
  2. Choisissez la récompense que l'utilisateur reçoit lorsqu'il utilise un code promo : aucune récompense, remise sur tous les objets du panier, remise sur des objets spécifiques, objets bonus, ou une combinaison de ces options.
  3. Définissez le montant de la remise.
  4. Cliquez sur Next.

  1. Spécifiez le nombre total d'utilisations et le nombre d'utilisations par utilisateur.
  2. Cliquez sur Next.

  1. Définissez les dates de début et de fin de la promotion.
  2. Cliquez sur Next.

  1. Vérifiez les paramètres et cliquez sur Save and exit.

Note
Tant qu’une promotion est active, vous ne pouvez pas la modifier.
  1. Dans le menu latéral, cliquez sur Store, puis sur Promotions and rewards.
  2. Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit promotion.
  1. Accédez à l'onglet Codes.
  2. Spécifiez comment les coupons sont générés.
  3. Générez le code promo ou saisissez-le manuellement.
  1. Activez la promotion.

Échanger un code promo

Note
Pour appeler les API de Xsolla, vous pouvez utiliser les méthodes SDK prêtes à l’emploi pour les moteurs de jeu et les plateformes :

Implémentez l’appel à la méthode Redeem promo code pour utiliser un code promo. Selon la valeur du paramètre is_selectable, il existe deux flux possibles dans la réponse à la méthode Get promo code rewards :

  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 :

Copy
Full screen
Small screen
selected_unit_items:{
      unit_1_sku: "selected_unit_item_sku",
      unit_2_sku: "selected_unit_item_sku"
}

Exemple de réponse :

Copy
Full screen
Small screen
{
  {
    "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
    }
    ]
}
  1. Si is_selectable=false, vous ne devez pas passer de paramètres supplémentaires dans la requête.

Obtenir la récompense associée au code promo

Note
Pour appeler les API de Xsolla, vous pouvez utiliser les méthodes SDK prêtes à l’emploi pour les moteurs de jeu et les plateformes :

Appelez la méthode Get promo code rewards pour obtenir la liste des objets que l’utilisateur reçoit après avoir échangé un code promo. Selon la valeur du paramètre is_selectable dans la réponse, deux flux sont possibles :

  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.
Voici un exemple de réponse :

Copy
Full screen
Small screen
{
	"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
  1. Si is_selectable=false, vous ne devez pas passer de paramètres supplémentaires dans la requête.

Campagne promotionnelle avec des bonus

Avis
Dans les campagnes avec remises, codes promo ou coupons, seuls les packages de monnaie virtuelle sont utilisés. La monnaie virtuelle en quantité arbitraire est réservée aux campagnes avec bonus.

Pour lancer une campagne promotionnelle avec un bonus :

  1. Ouvrez votre projet dans le Compte éditeur.
  2. Dans le menu latéral, cliquez sur Store et accédez à Promotions and rewards.

  1. Cliquez sur Create promotion.

  1. Spécifiez les paramètres suivants :
    1. Entrez le titre de la promotion ;
    2. Choisissez Bonus comme type de promotion.
  2. Sélectionnez les objets promotionnels.

  1. Choisissez les objets à accorder à l'utilisateur pour l'achat d'un objet promotionnel.
  2. Cliquez sur Next.

  1. Pour que la promotion s'applique uniquement aux utilisateurs effectuant leur premier achat, réglez la bascule Trigger promotion only for first-time buyers sur On. Les options Limit number of times one user can use promotion et Promotion for only specific users seront automatiquement activées, et un ensemble de conditions pour déclencher la promotion sera créé. Ajoutez des conditions supplémentaires si nécessaire.
  2. Cliquez sur Next.

  1. Définissez les dates de début et de fin de la promotion.
  2. Cliquez sur Next.

  1. Vérifiez les paramètres et cliquez sur Save and exit.

Note
Tant qu’une promotion est active, vous ne pouvez pas la modifier.

  1. Dans le menu latéral, cliquez sur Store, puis sur Promotions and rewards.
  2. Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit promotion.

  1. Activez la promotion.

Campagne promotionnelle avec des remises

Note
Il est impossible d’appliquer des restrictions régionales aux promotions.

Configurer une campagne promotionnelle avec des remises dans le Compte éditeur

Pour lancer une campagne promotionnelle avec une remise :
  1. Ouvrez votre projet dans le Compte éditeur.
  2. Dans la barre latérale, cliquez surStore.

  1. Cliquez sur Promotions and rewards > Create promotion.

  1. Spécifiez les paramètres suivants :
    1. Entrez le titre de la promotion ;
    2. Choisissez Bonus comme type de promotion.
  2. Configurez les remises qui s'appliquent à un ou plusieurs objets.
  3. Définissez le montant de la remise.
  4. Cliquez sur Next.

  1. Pour que la promotion s'applique uniquement aux utilisateurs effectuant leur premier achat, réglez la bascule Trigger promotion only for first-time buyers sur On. Les options Limit number of times one user can use promotion et Promotion for only specific users seront automatiquement activées, et un ensemble de conditions pour déclencher la promotion sera créé. Ajoutez des conditions supplémentaires si nécessaire.
  2. Cliquez sur Next.

  1. Définissez les dates de début et de fin de la promotion.
  2. Cliquez sur Next.

  1. Vérifiez les paramètres et cliquez sur Save and exit.

Note
Tant qu’une promotion est active, vous ne pouvez pas la modifier.

  1. Dans le menu latéral, cliquez sur Store, puis sur Promotions and rewards.
  2. Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit promotion.

  1. Activez la promotion.

Configurer une campagne promotionnelle avec des remises via API

Pour configurer les promotions par réduction, vous pouvez utiliser les méthodes de la sous-section Discount du groupe de méthodes Promotions.

Pour créer la promotion via les méthodes API :

  1. Appelez la méthode Create discount promotion for item avec les paramètres requis.
  2. Appelez la méthode Update item promotion avec le paramètre “is_enabled”:true pour activer la promotion.

Pour modifier la promotion via une API, appelez la méthode Update item promotion avec les nouveaux paramètres de promotion. Vous pouvez également modifier la promotion dont le statut est Active.

Lorsque vous créez ou modifiez une promotion par réduction via les méthodes API, vous pouvez également :

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: 16 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 !