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, puis sur Promotions and rewards.

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 d'utilisations et le nombre d'utilisations par utilisateur.

9. Définissez les dates de début et de fin de la promotion.
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, puis sur Promotions and rewards.
13. Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit promotion.

14. Accédez à l'onglet Codes.
15. Spécifiez comment les coupons sont générés.

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 Échanger un coupon 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 Échanger un code de coupon :

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, puis sur Promotions and rewards.

3. Cliquez sur Create promotion.

4. Spécifiez les paramètres suivants :
   1. Entrez le titre de la promotion.
   2. Choisissez Promo code comme type de promotion.
5. 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.
6. Définissez le montant de la remise.
7. Cliquez sur Next.

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

10. Définissez les dates de début et de fin de la promotion.
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, puis sur Promotions and rewards.
14. Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit promotion.

15. Accédez à l'onglet Codes.
16. Spécifiez comment les coupons sont générés.
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 Échanger un code promo 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 reward :

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

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 reward 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 and rewards.

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. Sélectionnez les objets promotionnels.

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

8. 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.
9. Cliquez sur Next.

10. Définissez les dates de début et de fin de la promotion.
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, puis sur Promotions and rewards.
14. Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit promotion.

15. 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 la barre latérale, cliquez surStore.

3. Cliquez sur Promotions and rewards > Create promotion.

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

8. 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.
9. Cliquez sur Next.

10. Définissez les dates de début et de fin de la promotion.
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, puis sur Promotions and rewards.
14. Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit promotion.

15. Activez la promotion.

Configuration via des méthodes API

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

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

1. Appelez la méthode Créer une promotion par réduction pour un objet avec les paramètres requis.
2. Appelez la méthode Mettre à jour une promotion sur les objets avec le paramètre “is_enabled”:true pour activer la promotion.

Pour modifier la promotion via une API, appelez la méthode Mettre à jour une promotion sur les objets 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 Créer une promotion par réduction pour un objet ou Mettre à jour une promotion sur les objets.

"items": null

• Configurer une remise sur les biens physiques. Passez un tableau contenant les UGS de biens physiques à la méthode Créer une promotion par réduction pour un objet ou Mettre à jour une promotion sur les objets.
  Copy

  Full screen

  Small screen

  • json

  
  "items": [{
       “sku”: “strw2030”
    }, {
       “sku”: “strw4060”
    }, {
       “sku”: “cupred200”
    }
  ]
  

  • Définir une remise avec une valeur de pourcentage fractionnaire. Passez le paramètre discount.percent avec une fraction de remise à la méthode Créer une promotion par réduction pour un objet ou Mettre à jour une promotion sur les objets.

"discount": {
    “percent”: ”49.9”
}

• Configurer une remise sur différents types d'objets. Passez un tableau contenant les UGS des objets requis à la méthode Créer une promotion par réduction pour un objet ou Mettre à jour une promotion sur les objets.

"items": [{
     “sku”: “storm_shield”
  }, {
     “sku”: “heaven_crystals_pack_x500”
  },{
     “sku”: “strw2030”
  }
]

• Configurer une remise sur certains DRM du jeu. Passez un tableau contenant les SKU des DRM requis à la méthode Créer une promotion par réduction pour un objet ou Mettre à jour une promotion sur les objets.

"items": [{
     “sku”: “brilliant_game_sku_steam”
  }
  ]

• Configurer une promotion par réduction à durée indéterminée. Passez le paramètre “date_end”:null à la méthode Créer une promotion par réduction pour un objet ou Mettre à jour une promotion sur les objets.

“date_end”: null

• Configurez une promotion pour les nouveaux acheteurs. Pour ce faire, passez dans l'appel API Créer une promotion par réduction pour un objet un objet ou dans l'appel API Mettre à jour une promotion sur les objets un objet dans un tableau attribute_conditions :

"attribute_conditions": [
{
"attribute": "has_purchase",
"operator": "eq",
"value": "0",
"type": "number"
}
],
"limits": {
"per_user": 1
}