Limites d’utilisation de promotion

Comment ça marche

Vous pouvez définir une limite du nombre d’utilisations d’une promotion par utilisateur et programmer des réinitialisations de ces limites. La configuration des limites est disponible pour les promotions par réduction et par bonus. Vous pouvez activer des réinitialisations périodiques des limites pour :

• autoriser les achats répétés avec la même promotion
• synchroniser les données avec votre système lorsque des objets sont vendus sur plusieurs plateformes de distribution de jeux

Une fois que l’utilisateur atteint la limite d’utilisation de la promotion, l’objet est disponible au prix plein, sans réduction ni bonus.

Pour afficher correctement le nombre d’utilisations restantes pour un utilisateur, vous devez configurer l’authentification.

Les utilisateurs non authentifiés voient toujours le nombre maximal d’utilisations de la promotion. Pour afficher le nombre d’utilisations restantes pour un utilisateur avec la limite active appliquée, incluez les données d’autorisation de l’utilisateur lors de la requête :

• le catalogue des objets en utilisant les appels de la sous-section Catalogue du groupe Objets et monnaie virtuels
• le catalogue des jeux en utilisant les appels de la sous-section Catalogue du groupe Clés de jeu

Pour configurer des limites d’achat d’objet, consultez les instructions.

Configuration et mis à jour des limites

Configuration et mise à jour dans le Compte éditeur

Pour créer une promotion à usage limité :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section LiveOps > Promotions.
2. Appuyez sur Create promotion.
3. Entrez le titre de la promotion.
4. Dans la liste déroulante, choisissez le type Discount ou Bonus.
5. Remplissez les champs selon le type de promotion sélectionné.
6. Appuyez sur Next.
7. Pour limiter le nombre de ventes, dans la page Conditions, réglez la bascule Limit number of times one user can use promotion sur On et indiquez le nombre d’utilisations.

8. Pour configurer des promotions personnalisées, réglez la bascule Promotion for only specific users sur On et suivez ces instructions.
9. Appuyez sur Next.
10. Définissez les dates de début et de fin de la campagne en précisant le fuseau horaire. Pour rendre la promotion disponible indéfiniment, sélectionnez No end date.
11. Appuyez sur Next.
12. Vérifiez les paramètres et cliquez sur Save and exit.
13. Pour activer une promotion :
    1. Trouvez la promotion dans votre catalogue des promotions.
    2. Appuyez sur le bouton de menu ••• et sélectionnez Edit promotion.
    3. Dans le coin supérieur droit, ouvrez le menu déroulant et sélectionnez Activate promotion.

Pour configurer ou mettre à jour les limites d’une promotion existante :

1. Ouvrez le projet dans le Compte éditeur et accédez à la section LiveOps > Promotions.
2. Dans la ligne de la promotion, appuyez sur ••• et sélectionnez Edit promotion dans la liste déroulante.
3. Si la promotion dont vous avez besoin est active, désactivez-la dans le coin supérieur droit de la liste déroulante.
4. Sur la page Condition and limits, appuyez sur Refresh this limit manually.
5. Confirmez l’action et appuyez sur Save changes.
6. Pour activer la promotion, ouvrez le menu déroulant dans le coin supérieur droit et sélectionnez Activate promotion.

Configuration et mise à jour via appels API

Pour définir des limites quotidiennes, hebdomadaires ou mensuelles, passez le tableau limits dans les appels API suivants :

• Créer une promotion par réduction pour un objet ;
• Créer une promotion par bonus.

Pour mettre à jour et gérer les limites, utilisez les appels API de la section Limits :

Affichage des limites dans le catalogue des objets

Les limites d’utilisation de promotion sont affichées dans le catalogue selon leur mode d’implémentation : au moyen du constructeur de site ou via API.

Affichage via le constructeur de site

Si vous utilisez le constructeur de site, les limites s’affichent automatiquement. Après avoir défini une limite d’utilisation pour la promotion, la carte d’objet affiche :

• le montant de la remise pour les promotions par réduction
• un message bonus pour les promotions par bonus
• un compteur indiquant le nombre d’objets promotionnels disponibles à l’achat

Obtention des informations sur les limites via API

Si le catalogue est implémenté via API, les informations sur les limites d’utilisation de la promotion sont renvoyées dans le tableau promotions.limits lors des appels API suivants liés au catalogue :

• Lire une liste d’objets virtuels
• Lire une liste de monnaies virtuelles
• Lire la liste des packages de monnaie virtuelle
• Get bundles list
• Lire la liste des jeux

Vous pouvez utiliser ces données pour afficher les limites d’utilisation des promotions dans le catalogue, par exemple pour indiquer le nombre maximal d’utilisations disponibles pour l’utilisateur.Dernière mise à jour: 13 Février 2026