API for berettigede promoteringer
Bruk API-et for berettigede promoteringer til å gi kunder en liste over promoteringer som er berettiget til kundevogner. API kan hente listen over kvalifiserte promoteringer for kontakter, kontoer og lojalitetsprogrammedlemmer.
Nødvendige utgaver
| Tilgjengelig i Lightning Experience |
| Tilgjengelig i Enterprise, Unlimited og Developer Edition med tilbudsbehandling i sanntid |
Gi kundene en liste over promoteringer som er berettiget til deres handlevogn. API-et tar en kundes handlevogndetaljer som forespørsel og gir detaljene om de kvalifiserte aktive promoteringene for handlevognen som svar. Når du ser etter kvalifiserte promoteringer for et element, skanner API-et fem nivåer i produktets kategorihierarki.
Hvis en handlevogn inneholder et produkt som ikke finnes i Salesforce-katalogen, ignorerer API-et de usynkroniserte produktene mens det evaluerer promoteringer på linjenivå og på tvers av linjenivå, og viser kvalifiserte promoteringer for handlevognen.
Hvis en organisasjon har flere regelbiblioteker av typen Global Promoteringsbehandling, må systemintegratorer angi hvilket regelbibliotek APIen skal utføre. De må også bekrefte at API-forespørselen inneholder verdier som regelbibliotekets kontekstdefinisjon krever for å evaluere handlevogner.
API-svaret inneholder disse promoteringsdetaljene.
- Promoteringens primære detaljer, som start- og sluttdatoer
- Promoteringens tilpassede feltverdier
- Promoteringens grenser
- Promoteringsregler som er berettiget til kundens handlevogn
- Promoteringens tilpassede feltverdier som er tilordnet i promoteringskontekstdefinisjonen.
For å gi kunder sine kvalifiserte promoteringer i sanntid, integrerer du API-et for kvalifiserte promoteringer med eksterne systemer som administrerer handlevogn. Se kvalifiserte promoteringer.
Når en promotors bruk oppfyller promoteringens grense for en bestemt handlevogn, gir ikke API for berettigede promoteringer belønningen i API-utdataene til noen kunde. Når en kundes bruk av en belønn oppfyller promoteringens grense for kundenivå, tilbyr ikke APIen for berettigede promoteringer lenger belønningen til kunden.
Slik ser forespørselen i Eligible Promotion API-et ut når API-et utføres fra Cloud Kicks' nettsted for online shopping.
{
"cart":{
"Accessory":[
{
"activityStartDate":"2023-06-14T12:45:19Z",
"contactId":"003xx000004WjzAAAS",
"transactionAmount":85,
"currencyISOCode":"INR",
"cartLineDetails":[
{
"CartLineProductCategory":"Sneaker Shields",
"cartLineProductCatalogId:"0ZSSB0000002d8X4AQ"",
"AttributeKey:"Premium"
}
]
}
]
}
}Berettigede promoterings-API for promoteringer med kuponger
Når kuponger legges til i en promotering, tar API-et for berettigede promoteringer en kundes handlevogndetaljer som forespørsel og svarer med detaljene for de aktive kupongene for promoteringene som er berettiget til kundens handlevogn. Kunden kan bruke kupongen for promoteringen som de vil bruke på handlevognen sin.
For kvalifiserte promoteringer som inkluderer en kupong, inkluderer API-ens svar disse kupongdetaljene.
- Kupongkode
- Start- og sluttdatoer
- Status
APIen returnerer bare promoteringer som har minst én aktiv og gyldig kupong for kundens aktivitetsdato. Selv om en promotering kan bestå av flere kuponger, viser ikke API-et kupongkoden i disse scenariene.
- Hvis det er flere aktive kuponger som er berettiget til aktivitetsdatoen
- Hvis ingen kupong er aktiv for aktivitetsdatoen
- Hvis den kvalifiserte aktive kupongen har nådd grensen for bruk

