Vous êtes ici :
Conception de promotions par programmation
Utilisez l'API de création de promotions pour créer, configurer et gérer des promotions. Les intégrateurs système peuvent intégrer de façon transparente l'API à des systèmes externes dans lesquels des utilisateurs tels que des responsables de magasin peuvent créer des promotions.
Éditions requises
| Disponible avec : Lightning Experience |
| Disponible avec : Éditions Enterprise, Unlimited et Developer avec Gestion des offres en temps réel |
Pour créer une promotion, spécifiez les détails principaux, les règles de promotion et les récompenses. Lorsque vous spécifiez les détails des règles et des récompenses, mappez les détails que vous spécifiez avec le type de modèle de promotion que vous souhaitez utiliser dans la promotion. Vous pouvez également spécifier des critères d'éligibilité et des limites pour la promotion.
Vous pouvez également utiliser l'API pour mettre à jour et supprimer des promotions, et récupérer les détails des promotions. Pour comprendre comment concevoir une promotion, consultez Étapes de l'assistant Promotion rapide.
La requête de l'API Promotion Creation se présente comme suit lors de l'exécution de l'API :
{
"promotionDetails": {
"name": "Summer Sale",
"displayName": "Summer Sale Promotion",
"priorityNumber": 1,
"description": "Summer Sale promotion offering a 10% discount on purchases over $50",
"promotionCode": "SUMMER2025",
"startDateTime": "2025-06-01T00:00:00.000Z",
"endDateTime": "2025-06-30T23:45:00.000Z",
"loyaltyProgram": {
"name": "CloudKicksLoyalty"
},
"promotionEligibility": {
"productCatalog": {
"id": "0ZSxx000000001dGAA"
},
"eligibleProductCategories": [
{
"id": "Summer Sneakers"
}
],
"eligibleChannels": [
{
"channelType": "Online",
"channel": {
"name": "App"
}
}
],
"eligibleSegments": [
{
"name": "Loyal Customers"
}
],
"areAllLoyaltyMembersEligible": false
},
"promotionLimits": {
"usePerCustomerLimit": 5,
"totalUseLimit": 1000
}
},
"rules": [
{
"templateName": "BuyXToGetRewards",
"ruleName": "SummerSaleRule",
"priority": 1,
"eventConfiguration": [
{
"allOf": [
{
"anyOf": {
"purchaseType": "ProductCategory",
"applicablePurchaseList": [
{
"name": "Summer Sneakers"
}
],
"purchaseCriteria": {
"type": "Amount",
"value": 50
}
}
}
]
}
],
"rewardConfiguration": [
{
"type": "ProvideDiscount",
"rewardDetails": {
"discountValue": "10",
"discountType": "PercentageOff"
},
"targetAudience": {
"audienceType": "AllLoyaltyMembers"
}
}
]
}
]
}