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 | Sì | string | Identificativo unico del carrello. |
| totalQuantity | Sì | number | Quantità totale di prodotti presenti nel carrello. |
| totalPrice | Sì | number | Prezzo totale del carrello. |
| products | Sì | 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 | Sì | number | Quantità di unità di questo prodotto. |
| price | Sì | 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:
- Aggiungere il JavaScript di Connectif al tuo sito web, per inserire il codice e iniziare a raccogliere informazioni sulle visite alla tua pagina.
- Integrazione tramite tag, per conoscere tutte le notifiche che puoi inviare dal tuo eCommerce a Connectif e il loro funzionamento.
- Integrazione con Connectif via API, per sincronizzare contatti, prodotti, acquisti e coupon.
- Verificare l'integrazione con l'eCommerce, per assicurarti che tutti i dati vengano sincronizzati correttamente nel tuo account Connectif.