Progettazione di promozioni a livello di programmazione
Utilizzare l'API di creazione delle promozioni per creare, configurare e gestire le promozioni. Gli integratori di sistemi possono integrare perfettamente l'API con i sistemi esterni in cui utenti come i responsabili dei punti vendita possono creare promozioni.
Versioni (Edition) richieste
| Disponibile nelle versioni: Lightning Experience |
| Disponibile in: Enterprise Edition, Unlimited Edition e Developer Edition con Gestione offerte in tempo reale |
Per creare una promozione, specificare i dettagli principali, le regole di promozione e i premi. Quando si specificano i dettagli delle regole e dei premi, mappare i dettagli specificati al tipo di modello di promozione che si desidera utilizzare nella promozione. È anche possibile specificare criteri e limiti di idoneità per la promozione.
È anche possibile utilizzare l'API per aggiornare ed eliminare le promozioni e per recuperare i dettagli delle promozioni. Per informazioni su come progettare una promozione, vedere i passaggi della procedura guidata.
La richiesta dell'API creazione promozione si presenta come segue quando l'API viene eseguita:
{
"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"
}
}
]
}
]
}