Speciale acties programmatisch ontwerpen
Gebruik de API voor het maken van speciale acties om speciale acties te maken, configureren en beheren. Systeemintegrators kunnen de API naadloos integreren met externe systemen waarin gebruikers zoals storemanagers speciale acties kunnen maken.
Vereiste editions
| Beschikbaar in: Lightning Experience |
| Beschikbaar in: Enterprise, Unlimited en Developer Edition met realtime aanbiedingsbeheer |
Geef voor het maken van een speciale actie de primaire details, regels voor speciale actie en beloningen op. Wanneer u de details van de regels en beloningen opgeeft, wijst u de details die u opgeeft, toe aan het type speciale actiesjabloon dat u in de speciale actie wilt gebruiken. U kunt ook aanspraakcriteria en limieten voor de speciale actie opgeven.
U kunt de API ook gebruiken om speciale acties bij te werken en te verwijderen, en om details van speciale acties op te halen. Zie Wizardstappen voor Snelle speciale actie voor meer informatie over het ontwerpen van een speciale actie.
Zo ziet het verzoek van de API voor het maken van speciale acties eruit wanneer de API wordt uitgevoerd:
{
"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"
}
}
]
}
]
}