Notificare le informazioni del carrello

L'evento “Notifica informazioni sul carrello” serve per descrivere il carrello della spesa che ha il contatto in un determinato momento. Per fare ciò, notifica via JavaScript i prodotti e lo stato del carrello di un contatto utilizzando la funzione connectif.managed.sendEvents.

  

Questo articolo fa parte della guida per creare un'integrazione personalizzata.
Se la tua integrazione avviene tramite modulo, questa notifica verrà inserita automaticamente nel tuo eCommerce.

 

Come si usa

La notifica delle informazioni sul carrello utilizza l'opzione entityInfo del metodo sendEvents,  per arricchire le informazioni sugli eventi inviati. Questa notifica descrive l'intero carrello, Connectif si occupa di rilevare le modifiche e generare gli eventi appropriati quando un prodotto viene aggiunto o rimosso dal carrello.

  

Questa notifica via JavaScript rappresenta un'alternativa all'implementazione del Tag "Stato attuale del carrello della spesa" nell'HTML della pagina del tuo negozio o sito web.

Notificare il carrello della spesa

Questo oggetto rappresenta un carrello della spesa completo in un determinato momento. Include le seguenti proprietà:

Nome Obbligatorio Tipo Descrizione
cartId string Identificativo unico del carrello.
totalQuantity number Quantità totale di prodotti presenti nel carrello.
totalPrice number Prezzo totale del carrello.
products Product Basket Item Articoli contenuti nel carrello, con la quantità e il prezzo totale di ciascuno.

Notificare i prodotti tramite Product Basket Item

Questo oggetto rappresenta i prodotti, la loro quantità e il prezzo totale all'interno di un carrello della spesa o di un acquisto.

Include tutte le proprietà del tipo di oggetto Prodotto (maggiori informazioni in Notificare evento di prodotto visitato), oltre alle seguenti:

Nome Obbligatorio Tipo Descrizione
quantity number Quantità di unità di questo prodotto.
price number Prezzo totale dei prodotti rappresentati da questo Product Basket Item. Normalmente è quantity * unitPrice.

 

Altre considerazioni

È molto importante impostare un identificatore del carrello ("cartId") e notificare Connectif anche quando il carrello viene svuotato, per prevenire la generazione di eventi di carrelli abbandonati.

 

Esempio

La notifica avrà questo aspetto:

const cart = {
    cartId: '123456789',
    totalQuantity: 1,
    totalPrice: 10.2,
    products: [{
        quantity: 1,
        price: 10.2,
        productDetailUrl: 'https://mywebsite.com/myproduct-detail-url',
        productId: '12345678910',
        name: 'Il mio prodotto',
        description: 'descrizione del prodotto',
        imageUrl: 'https://mywebsite.com/images/myproduct',
        unitPrice: 10.2,
        availability: 'InStock',
        categories: ['/Home'],
        tags: ['tag1','tag2'],
        brand: 'Brand',
        reviewCount: 1,
        rating: 2,
        ratingCount: 2,
        thumbnailUrl: 'https://mywebsite.com/images/thumb/myproduct',
        priority: 20,
        unitPriceOriginal: 10.2,
        unitPriceWithoutVAT: 8,
        discountedAmount: 0,
        discountedPercentage: 0,
        publishedAt: '2020-05-20T15:24:20Z',
        customField1: '',
        customField2: '',
        customField3: ''
    }]
};
connectif.managed.sendEvents([ // qui i miei eventi, se presenti ], { entityInfo, cart });

 

 

Congratulazioni!
Hai completato la lezione.

  

Hai ancora domande?
Ricorda che hai a disposizione i nostri specialisti di Connectif. Per contattarli, basta aprire un ticket di supporto cliccando sul pulsante blu “Aiuto” della tua dashboard.


Continua a imparare!

Per sfruttare tutto il potenziale del tuo account Connectif, ti consigliamo di continuare con i seguenti articoli: