Loading
Få mere at vide om administration af tilbud i realtid
API for berettigede kampagner

breadcrumbDescription

  1. helpHomeLinkText
  2. docsHomeLinkTextShort
  3. Administration af tilbud i realtid

API for berettigede kampagner

Brug API'en for berettigede kampagner til at give kunderne en liste over kampagner, der er berettigede til kundevogner. API'en kan hente listen over kvalificerede kampagner for kontakter, konti og loyalitetsprogrammedlemmer.

EditionsHeading

Tilgængelig i: Lightning Experience
Tilgængelig i: Enterprise, Unlimited og Developer Edition med tilbudsstyring i realtid

Giv dine kunder en liste over kampagner, der er berettiget til deres indkøbsvogn. API'en tager en kundes indkøbsvogns detaljer som anmodningen og angiver detaljerne for de berettigede aktive kampagner for indkøbsvognen som svaret. Når du søger efter kvalificerede kampagner for et element, scanner API 5 niveauer af produktets kategorihierarki.

Hvis en indkøbsvogn indeholder et produkt, der ikke findes i Salesforce-kataloget, ignorerer API'en de usynkroniserede produkter, mens den evaluerer kampagner på linjeniveau og på tværs af linjeniveau og viser kvalificerede kampagner for indkøbsvognen.

Hvis en organisation har flere regelbiblioteker af typen Global promoveringsstyring, skal systemintegratorer angive, hvilket regelbibliotek API'en afvikler. De skal også bekræfte, at API'ens anmodning indeholder værdier, som regelbibliotekets kontekstdefinition kræver for at evaluere indkøbsvogner.

Vigtigt
Vigtigt Når API ikke finder værdien for en tilpasset attribut eller en produktattribut i anmodningen, antages værdien at være fraværende i indkøbsvognen.

API-svaret leverer disse kampagnedetaljer.

  • Reklamekampagnens primære detaljer, f.eks. start- og slutdatoer
  • Reklamekampagnens tilpassede feltværdier
  • Reklamekampagnens grænser
  • Kampagnens regler, der er kvalificerede til kundens indkøbsvogn
  • Kampagnens tilpassede feltværdier, der er tilknyttet i definitionen af kampagnekonteksten.

Hvis du vil levere kunderne deres kvalificerede kampagner i realtid, skal du integrere API for kvalificerede kampagner med eksterne systemer, der administrerer kundevogne. Se berettigede kampagner.

Tip
Tip Mens du integrerer API med eksterne systemer, f.eks. indkøbslokaliteter, point-of-sales-systemer (POS-systemer) og globale distributionssystemer (GDS), bruger du enten registrerings-id'et eller navne til at identificere nøgleattributter for indkøbsvognen. Hvis du f.eks. vil identificere den kunde, som indkøbsvognen tilhører, skal du enten angive id'et på kundens kontaktregistrering eller efternavnet og mailen på kontakten. Hvis du vil identificere loyalitetsprogrammedlemmer, som indkøbsvognen tilhører, skal du enten angive medlemmets registrerings-id for loyalitetsprogrammedlem eller deres medlemskabsnummer. Hvis du vil identificere produkter eller kategorier, hvorfra produkter føjes til kundens indkøbsvogn, skal du enten angive produkt-id'et eller produktnavnet eller kategori-id'et eller navnet.

Når en reklamekampagnes anvendelse opfylder reklamekampagnens grænse for en bestemt indkøbsvogn, giver API for berettigede reklamekampagner ikke belønningen i API-outputtet for nogen kunde. Når en kundes brug af en belønning opfylder kampagnens grænse på kundeniveau, tilbyder API'en for berettigede kampagner ikke længere belønningen til kunden.

Example
Example Administratoren og marketingmanageren på Cloud Kicks har samarbejdet om at oprette en tilpasset kontekstdefinition for en reklamekampagne, der målrettes mod sneakerheads-segmentet, der køber premium sneaker-skilte med en værdi på USD 75.

Her kan du se, hvordan API'en for berettiget reklamekampagne ser ud, når API'en køres fra Cloud Kicks' onlineshoppinglokalitet.

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

Berettigede kampagner-API for kampagner med kuponer

Når der føjes kuponer til en reklamekampagne, tager API'en Berettigede reklamekampagner en kundes indkøbsvogns detaljer som anmodningen og svarer med detaljerne for de aktive kuponer for de reklamekampagner, der er berettiget til kundens indkøbsvogn. Kunden kan bruge kuponen for den reklamekampagne, som vedkommende ønsker at anvende på sin indkøbsvogn.

For kvalificerede kampagner, der inkluderer en kupon, inkluderer API'ens svar disse kupondetaljer.

  • Kuponkode
  • Start- og slutdatoer
  • Status

API returnerer kun kampagner, der har mindst en aktiv og gyldig kupon for kundens aktivitetsdato. Selvom en reklamekampagne kan bestå af flere kuponer, viser API'en ikke kuponkoden i disse scenarier.

  • Hvis der er flere aktive kuponer, der er berettiget til aktivitetsdatoen
  • Hvis ingen kupon er aktiv for aktivitetsdatoen
  • Hvis den berettigede aktive kupon har nået dens anvendelsesgrænse
 
Indlæser
Salesforce Help | Article