API för kvalificerade erbjudanden

Du är här:

API för kvalificerade erbjudanden

Använd API för kvalificerade erbjudanden för att ge kunder en lista över erbjudanden som är kvalificerade för kundvagnar. API kan få listan över kvalificerade erbjudanden för kontakter, konton och lojalitetsprogrammedlemmar.

Versioner som krävs

Tillgängliga i: Lightning Experience

Tillgängliga i: Enterprise, Unlimited och Developer Editions med erbjudandehantering i realtid

Ge dina kunder en lista över erbjudanden som är tillgängliga för deras varukorg. API tar en kunds varukorgsdetaljer som begäran och ger detaljerna om de kvalificerade aktiva erbjudandena för varukorgen som svaret. När du letar efter kvalificerade erbjudanden för ett objekt söker API igenom 5 nivåer i produktens kategorihierarki.

Om en varukorg innehåller en produkt som inte finns i Salesforce-katalogen ignorerar API de osynkroniserade produkterna vid utvärdering av erbjudanden på radnivå och korsradsnivå och visar kvalificerade erbjudanden för varukorgen.

Om en organisation har flera regelbibliotek av typen Global erbjudandehantering måste systemintegrerare specificera vilket regelbibliotek som API kör. De måste även bekräfta att API-begäran innehåller värden som regelbibliotekets sammanhangsdefinition kräver för att utvärdera varukorgar.

Viktig Om API inte hittar värdet för ett eget attribut eller ett produktattribut i begäran antas värdet saknas i varukorgen.

API-svaret tillhandahåller dessa erbjudandedetaljer.

Kampanjens primära detaljer som start- och slutdatum
Kampanjens egna fältvärden
Kampanjens gränser
Kampanjregler som är kvalificerade för kundens varukorg
Kampanjens egna fältvärden som mappas i erbjudandesammanhangsdefinitionen.

För att ge kunder deras kvalificerade erbjudanden i realtid, integrera API för kvalificerade erbjudanden med externa system som hanterar kunders varukorgar. Se Berättigade erbjudanden.

Tips När du integrerar API med externa system som shoppingwebbplatser, kassasystem och globala distributionssystem (GDS) använder du antingen post-ID eller namn för att identifiera nyckelattribut för varukorgen. Till exempel, för att identifiera kunden som varukorgen tillhör, specificera antingen ID för kundens kontaktpost eller efternamn och e-postadress för kontakten. För att identifiera medlemmar i lojalitetsprogram som varukorgen tillhör, specificera antingen medlemmens post-ID för medlem i lojalitetsprogram eller deras medlemsnummer. För att identifiera produkter eller kategorier från vilka produkter läggs till i kundens varukorg, specificera antingen produkt-ID eller produktnamn, eller kategori-ID eller namn.

Efter att ett erbjudandes användning uppfyller erbjudandets gräns för en specifik varukorg ger inte API för kvalificerade erbjudanden belöningen i API-utmatningen för någon kund. Efter att en kunds användning av en belöning uppfyller erbjudandets gräns på kundnivå erbjuder API för kvalificerade erbjudanden inte längre belöningen till kunden.

Exempel Administratören och marknadsföringschefen på Cloud Kicks har samarbetat för att skapa en egen sammanhangsdefinition för ett erbjudande som riktar sig till segmentet Sneakerheads som köper premium sneaker-sköldar med ett varukorgsvärde på 75 dollar.

Så här ser begäran från API för kvalificerande erbjudande ut när API körs från Cloud Kicks webbplats för onlineshopping.

{
   "cart":{
      "Accessory":[
         {
            "activityStartDate":"2023-06-14T12:45:19Z",
            "contactId":"003xx000004WjzAAAS",
            "transactionAmount":85,
            "currencyISOCode":"INR",
            "cartLineDetails":[
               {
                  "CartLineProductCategory":"Sneaker Shields",
                  "cartLineProductCatalogId:"0ZSSB0000002d8X4AQ"",
                  "AttributeKey:"Premium"
               }
            ]
         }
      ]
   }
}