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 :
- Configurez les attributs utilisateur pour votre projet.
- 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 :
- 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 :
- Configurez une campagne promotionnelle avec des coupons.
- Utilisez les méthodes pour échanger un coupon par code.
- Utilisez les méthodes pour obtenir la récompense associée à un coupon.
Configurer une campagne promotionnelle avec des coupons
- Ouvrez votre projet dans le Compte éditeur.
- Dans le menu latéral, cliquez sur Store, puis sur Promotions and rewards.
- Cliquez sur Create promotion.
- Spécifiez les paramètres suivants :
- Entrez le titre de la promotion ;
- Choisissez Coupons comme type de promotion.
- 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).
- Ajoutez :
- Identifiant promotionnel dans External ID ;
- Objets bonus que l'utilisateur reçoit lorsqu'il échange un coupon ;
- Type et quantité de l'objet.
- Cliquez sur Next.
- Spécifiez le nombre total d'utilisations et le nombre d'utilisations par utilisateur.
- Définissez les dates de début et de fin de la promotion.
- Cliquez sur Next.
- Vérifiez les paramètres et cliquez sur Save and exit.
- Dans le menu latéral, cliquez sur Store, puis sur Promotions and rewards.
- Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit promotion.
- Accédez à l'onglet Codes.
- Spécifiez comment les coupons sont générés.
- Générez le code de coupon ou saisissez-le manuellement.
- Activez la promotion.
Échange d'un coupon par code
Implémentez la méthode is_selectable
dans la réponse de l’appel à la méthode
- Si
is_selectable=true
, vous devez passer l’objetselected_unit_items
dans le format suivant lors de l’appel à la méthodeRedeem coupon code :
- http
selected_unit_items:{
unit_1_sku: "selected_unit_item_sku",
unit_2_sku: "selected_unit_item_sku"
}
Exemple de réponse :
- http
{
{
"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
}
]
}
- 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 is_selectable
dans la réponse, deux flux sont possibles :
- Si
is_selectable=true
, pour chaque élémentitem
avectype=unit
, vous devez afficher un formulaire permettant à l’utilisateur de choisir des éléments parmi ceux disponibles dans l’objetunit_items
. Dans ce formulaire, l’utilisateur choisit un seul élément pour chaque typeunit
.
- http
{
"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
- 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 :
- Configurez une campagne promotionnelle avec des codes promo.
- Implémentez les méthodes pour échanger des codes promo.
- Implémentez la méthode pour obtenir la récompense associée à un code promo.
Configurer une campagne promotionnelle avec des codes promo
- Ouvrez votre projet dans le Compte éditeur.
- Dans le menu latéral, cliquez sur Store, puis sur Promotions and rewards.
- Cliquez sur Create promotion.
- Spécifiez les paramètres suivants :
- Entrez le titre de la promotion.
- Choisissez Promo code comme type de promotion.
- 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.
- Définissez le montant de la remise.
- Cliquez sur Next.
- Spécifiez le nombre total d'utilisations et le nombre d'utilisations par utilisateur.
- Cliquez sur Next.
- Définissez les dates de début et de fin de la promotion.
- Cliquez sur Next.
- Vérifiez les paramètres et cliquez sur Save and exit.
- Dans le menu latéral, cliquez sur Store, puis sur Promotions and rewards.
- Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit promotion.
- Accédez à l'onglet Codes.
- Spécifiez comment les coupons sont générés.
- Générez le code promo ou saisissez-le manuellement.
- Activez la promotion.
Échanger un code promo
Implémentez l’appel à la méthode is_selectable
, il existe deux flux possibles dans la réponse à la méthode
- Si
is_selectable=true
, passez l’objetselected_unit_items
dans le format suivant lors de l’appel à la méthodeRedeem promo code :
- http
selected_unit_items:{
unit_1_sku: "selected_unit_item_sku",
unit_2_sku: "selected_unit_item_sku"
}
Exemple de réponse :
- http
{
{
"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
}
]
}
- 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 is_selectable
dans la réponse, deux flux sont possibles :
- Si
is_selectable=true
, pour chaque élémentitem
avectype=unit
, vous devez afficher un formulaire permettant à l’utilisateur de choisir des éléments parmi ceux disponibles dans l’objetunit_items
. Dans ce formulaire, l’utilisateur choisit un seul élément pour chaque typeunit
.
- http
{
"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
- 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 :
- Ouvrez votre projet dans le Compte éditeur.
- Dans le menu latéral, cliquez sur Store et accédez à Promotions and rewards.
- Cliquez sur Create promotion.
- Spécifiez les paramètres suivants :
- Entrez le titre de la promotion ;
- Choisissez Bonus comme type de promotion.
- Sélectionnez les objets promotionnels.
- Choisissez les objets à accorder à l'utilisateur pour l'achat d'un objet promotionnel.
- Cliquez sur Next.
- 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.
- Cliquez sur Next.
- Définissez les dates de début et de fin de la promotion.
- Cliquez sur Next.
- Vérifiez les paramètres et cliquez sur Save and exit.
- Dans le menu latéral, cliquez sur Store, puis sur Promotions and rewards.
- Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit promotion.
- Activez la promotion.
Campagne promotionnelle avec des remises
Configurer une campagne promotionnelle avec des remises dans le Compte éditeur
Pour lancer une campagne promotionnelle avec une remise :- Ouvrez votre projet dans le Compte éditeur.
- Dans la barre latérale, cliquez surStore.
- Cliquez sur Promotions and rewards > Create promotion.
- Spécifiez les paramètres suivants :
- Entrez le titre de la promotion ;
- Choisissez Bonus comme type de promotion.
- Configurez les remises qui s'appliquent à un ou plusieurs objets.
- Définissez le montant de la remise.
- Cliquez sur Next.
- 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.
- Cliquez sur Next.
- Définissez les dates de début et de fin de la promotion.
- Cliquez sur Next.
- Vérifiez les paramètres et cliquez sur Save and exit.
- Dans le menu latéral, cliquez sur Store, puis sur Promotions and rewards.
- Sélectionnez la promotion, cliquez sur le bouton du menu ••• pour ouvrir un menu, puis cliquez sur Edit promotion.
- 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
Pour créer la promotion via les méthodes API :
- Appelez la méthode
Create discount promotion for item avec les paramètres requis. - 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
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éthodeCreate discount promotion for item ouUpdate 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 ouUpdate 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éthodeCreate discount promotion for item ouUpdate 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 ouUpdate 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 ouUpdate item promotion .
- Configurer une promotion par réduction à durée indéterminée. Passez le paramètre
“date_end”:null
à la méthodeCreate discount promotion for item ouUpdate item promotion .
Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.