Loading
Informazioni su Gestione offerte in tempo reale
API Promozioni idonee

Ti trovi qui:

  1. Guida di Salesforce
  2. Documenti
  3. Gestione delle offerte in tempo reale

API Promozioni idonee

Utilizzare l'API Promozioni idonee per fornire ai clienti un elenco delle promozioni idonee per i carrelli dei clienti. L'API può ottenere l'elenco delle promozioni idonee per referenti, account e membri del programma fedeltà.

Versioni (Edition) richieste

Disponibile nelle versioni: Lightning Experience
Disponibile in: Enterprise Edition, Unlimited Edition e Developer Edition con Gestione offerte in tempo reale

Fornire ai clienti un elenco delle promozioni idonee per il carrello. L'API prende i dettagli del carrello di un cliente come richiesta e fornisce i dettagli delle promozioni attive idonee per il carrello come risposta. Quando si cercano promozioni idonee per un articolo, l'API analizza 5 livelli della gerarchia delle categorie del prodotto.

Se un carrello contiene un prodotto che non esiste nel catalogo Salesforce, l'API ignora i prodotti non sincronizzati durante la valutazione delle promozioni a livello di riga e a livello di riga e visualizza le promozioni idonee per il carrello.

Se un'organizzazione ha più librerie di regole di tipo Gestione promozioni globali, gli integratori di sistemi devono specificare quale libreria di regole viene eseguita dall'API. Devono inoltre confermare che la richiesta dell'API contiene i valori richiesti dalla definizione contesto della libreria di regole per valutare i carrelli.

Importante
Importante Quando l'API non trova il valore di un attributo personalizzato o di un attributo prodotto nella richiesta, si presume che il valore sia assente nel carrello.

La risposta API fornisce i seguenti dettagli della promozione.

  • I dettagli principali della promozione, ad esempio le date di inizio e fine
  • Valori dei campi personalizzati della promozione
  • Limiti della promozione
  • Regole della promozione idonee per il carrello del cliente
  • Valori dei campi personalizzati della promozione mappati nella definizione contesto della promozione.

Per fornire ai clienti le promozioni idonee in tempo reale, integrare l'API Promozioni idonee con i sistemi esterni che gestiscono i carrelli dei clienti. Vedere Promozioni idonee.

Suggerimento
Suggerimento Quando si integra l'API con sistemi esterni come siti di shopping, sistemi di punti vendita (POS) e sistemi di distribuzione globale (GDS), si utilizzano ID record o nomi per identificare gli attributi chiave del carrello. Ad esempio, per identificare il cliente a cui appartiene il carrello, specificare l'ID del record referente del cliente o il cognome e l'email del referente. Per identificare i membri del programma fedeltà a cui appartiene il carrello, specificare l'ID record del membro del programma fedeltà o il numero di appartenenza. Per identificare i prodotti o le categorie da cui i prodotti vengono aggiunti al carrello del cliente, specificare l'ID prodotto o il nome prodotto, oppure l'ID categoria o il nome.

Dopo che l'utilizzo di una promozione ha raggiunto il limite della promozione per un carrello specifico, l'API Promozioni idonee non fornisce il premio nell'output API per alcun cliente. Quando l'utilizzo di un premio da parte di un cliente raggiunge il limite a livello di cliente della promozione, l'API Promozioni idonee non offre più il premio al cliente.

Esempio
Esempio L'amministratore e il responsabile marketing di Cloud Kicks hanno collaborato per creare una definizione contesto personalizzata per una promozione destinata al segmento Sneakerheads che acquistano scudi sneaker premium con un valore del carrello di 75 US$.

Ecco come si presenta la richiesta dell'API Promozione idonea quando l'API viene eseguita dal sito di acquisti online Cloud Kicks.

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

API Promozioni idonee per le promozioni con coupon

Quando vengono aggiunti coupon a una promozione, l'API Promozioni idonee prende i dettagli del carrello di un cliente come richiesta e risponde con i dettagli dei coupon attivi per le promozioni idonee per il carrello del cliente. Il cliente può utilizzare il coupon della promozione che desidera applicare al carrello.

Per le promozioni idonee che includono un coupon, la risposta dell'API include i seguenti dettagli del coupon.

  • Codice coupon
  • Data iniziale e data finale
  • Stato

L'API restituisce solo le promozioni che hanno almeno un coupon attivo e valido per la data di attività del cliente. Sebbene una promozione possa essere costituita da più coupon, l'API non visualizza il codice coupon in questi scenari.

  • Se sono presenti più coupon attivi idonei per la data dell'attività
  • Se non è attivo alcun coupon per la data dell'attività
  • Se il coupon attivo idoneo ha raggiunto il limite di utilizzo
 
Caricamento
Salesforce Help | Article