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.

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 :

• package de monnaie virtuelle ;
• objet virtuel.

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 :

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

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

• un package de monnaie virtuelle ;
• un objet virtuel  un lot ou des objets à durée limitée.

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 :

• package de monnaie virtuelle ;
• objet virtuel y compris les objets à durée illimitée dans le temps.

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.

Configurer une campagne promotionnelle avec des coupons

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Store et accédez à Promotions.
3. Cliquez sur Create promotion.
4. Spécifiez les paramètres suivants :
   1. Entrez le titre de la promotion ;
   2. Choisissez Coupons comme type de promotion.
5. Choisissez la récompense que l'utilisateur reçoit lorsqu'il échange un coupon. Options disponibles :
   • Package de monnaie virtuelle ;
   • Objet virtuel (un ou plusieurs, y compris des lots et des objets à durée limitée).
6. 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.
7. Cliquez sur Next.
8. Spécifiez le nombre total de coupons pouvant être échangés et le nombre d'échanges par utilisateur.
9. Définissez les dates de début et de fin de la campagne.
10. Cliquez sur Next.
11. Vérifiez les paramètres et cliquez sur Save and exit.

12. Dans le menu latéral, cliquez sur Store et accédez à Promotions.
13. Sélectionnez la promotion, cliquez sur le bouton de menu ••• pour ouvrir le menu et cliquez sur Edit plan.
14. Accédez à l'onglet Codes.
15. Spécifiez la méthode de génération des coupons.
16. Générez le code de coupon ou saisissez-le manuellement.
17. Activez la promotion.

Échange d'un coupon par code

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 :

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.

Obtention de la récompense associée au coupon

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.

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

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 et accédez à Promotions.
3. Cliquez sur Create promotion.
4. Spécifiez les paramètres suivants :
   1. Entrez le titre de la promotion ;
   2. Choisissez Code promo comme type de promotion.
5. Choisissez ce que l'utilisateur reçoit lorsqu'il utilise un code promo : aucune récompense, réduction sur tous les objets du panier, réduction sur des objets spécifiques, objets bonus ou une combinaison de ce qui précède.
6. Définissez le montant de la remise.
7. Cliquez sur Next.
8. Spécifiez le nombre total de remboursements et le nombre de remboursements par utilisateur.
9. Cliquez sur Next.
10. Définissez les dates de début et de fin de la campagne.
11. Cliquez sur Next.
12. Vérifiez les paramètres et cliquez sur Save and exit.

13. Dans le menu latéral, cliquez sur Store et accédez à Promotions.
14. Sélectionnez la promotion, cliquez sur le bouton de menu ••• pour ouvrir le menu et cliquez sur Edit plan.
15. Accédez à l'onglet Codes.
16. Spécifiez la méthode de génération des codes promo.
17. Générez le code promo ou saisissez-le manuellement.
18. Activez la promotion.

Échanger un code promo

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 :

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.

Obtenir la récompense associée au code promo

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.

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

Campagne promotionnelle avec des 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.
3. Cliquez sur Create promotion.
4. Spécifiez les paramètres suivants :
   1. Entrez le titre de la promotion ;
   2. Choisissez Bonus comme type de promotion.
5. Choisissez des objets promotionnels.
6. Sélectionnez les objets offerts à l’utilisateur lorsqu’il achète des objets promotionnels.
7. Cliquez sur Next.
8. Si vous souhaitez que la promotion s’applique uniquement aux nouveaux acheteurs, réglez la bascule Trigger promotion only for first-time buyers sur On. Cela activera automatiquement les bascules Limit number of times one user can use promotion et Promotion for only specific users, et un ensemble de conditions de déclenchement de la promotion sera créé. Ajoutez des conditions supplémentaires si nécessaire.
9. Si vous souhaitez configurer la promotion pour des utilisateurs spécifiques, réglez la bascule Trigger promotion only for specific users sur On, et spécifiez la ou les conditions.
10. Si vous souhaitez limiter la disponibilité de la promotion à certains utilisateurs, réglez la bascule Limit number of times one user can use promotion sur On et spécifiez le nombre.
11. Cliquez sur Next.
12. Définissez les dates de début et de fin de la campagne.
13. Cliquez sur Next.Vérifiez les paramètres et cliquez sur Save and exit.

15. Dans le menu latéral, cliquez sur Store, puis sur Promotions.
16. Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit plan.
17. Activez la promotion.

Campagne promotionnelle avec des remises

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

1. Ouvrez votre projet dans le Compte éditeur.
2. Dans le menu latéral, cliquez sur Store.
3. Cliquez sur Promotions > Create promotion.
4. Spécifiez les paramètres suivants :
   1. Entrez le titre de la promotion ;
   2. Choisissez Discount comme type de promotion.
5. Configurez les remises qui s’appliquent sur un ou plusieurs objets.
6. Définissez le montant de la remise.
7. Cliquez sur Next.
8. Si vous souhaitez que la promotion s’applique uniquement aux nouveaux utilisateurs, réglez la bascule Trigger promotion only for first-time buyers sur On. Cela activera automatiquement les bascules Limit number of times one user can use promotion et Promotion for only specific users, et un ensemble de conditions de déclenchement de la promotion sera créé. Ajoutez des conditions supplémentaires si nécessaire.
9. Si vous souhaitez configurer la promotion pour des utilisateurs spécifiques, réglez la bascule Trigger promotion only for specific users sur On, et spécifiez la ou les conditions.
10. Si vous souhaitez limiter la disponibilité de la promotion à certains utilisateurs, réglez la bascule Limit number of times one user can use promotion sur On et spécifiez le nombre.
11. Cliquez sur Next.
12. Définissez les dates de début et de fin de la campagne.
13. Cliquez sur Next.Vérifiez les paramètres et cliquez sur Save and exit.

15. Dans le menu latéral, cliquez sur Store, puis sur Promotions.
16. Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit plan.
17. 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 :

• Configurer une remise sur tous les objets du projet. Passez le paramètre “items”:null à la méthode Create discount promotion for item ou Update item promotion.

• Configurer une remise sur les biens physiques. Passez un tableau contenant les SKU de biens physiques à la méthode Create discount promotion for item ou Update item promotion.

• Définir une remise avec une valeur de pourcentage fractionnaire. Passez le paramètre discount.percent avec une fraction de remise à la méthode Create discount promotion for item ou Update item promotion.

• Configurer une remise sur différents types d'objets. Passez un tableau contenant les SKU des objets requis à la méthode Create discount promotion for item ou Update item promotion.

• Configurer une remise sur certains DRM du jeu. Passez un tableau contenant les SKU des DRM requis à la méthode Create discount promotion for item ou Update item promotion.

• Configurer une promotion par réduction à durée indéterminée. Passez le paramètre “date_end”:null à la méthode Create discount promotion for item ou Update item promotion.