L’ evento “Notificare informazioni del carrello” serve a descrivere il carrello che il contatto ha in un dato momento. A tal fine, notifica tramite JavaScript i prodotti e lo stato del carrello di un contatto usando connectif.managed.sendEvents.
Come usare
La notifica delle informazioni del carrello utilizza l’opzione entityInfo del metodo sendEvents per arricchire le informazioni degli eventi inviati. Questa notifica descrive il carrello completo; Connectif gestisce il rilevamento dei cambiamenti e genera 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” nell’HTML del tuo negozio o pagina web.
Notificare il carrello
Questo oggetto rappresenta un carrello completo in un dato istante. Include le seguenti proprietà:
| Nombre | Obligatoria | Tipo | Descripción |
|---|---|---|---|
| cartId | Sì | string | Identificatore univoco del carrello. |
| totalQuantity | Sì | number | Quantità totale di prodotti presenti nel carrello. |
| CartRecoveryUrl | No | Cart recovery url | URL associata al carrello tramite la quale si può accedere per recuperare/acquistare tutti i prodotti correlati. |
| totalPrice | Sì | number | Prezzo totale del carrello. |
| products | Sì | Product Basket Item | Gli articoli che il carrello contiene, con le loro quantità e importi. |
Notificare i prodotti tramite Product Basket Item
Questo oggetto rappresenta i prodotti, le loro quantità e il prezzo totale in un acquisto o carrello.
Include tutte le proprietà del tipo oggetto Prodotto (maggiori informazioni in Notify product visited event), oltre alle seguenti:
| Nombre | Obligatoria | Tipo | Descripción |
|---|---|---|---|
| quantity | Sì | number | Quantità di unità di questo prodotto. |
| price | Sì | number | Prezzo accumulato dei prodotti rappresentati da questo Product Basket Item. Generalmente quantity * unitPrice. |
Altre considerazioni
È molto importante definire un identificatore del carrello (“cartId”) e notificare Connectif anche quando il carrello viene svuotato, per evitare che vengano generati eventi di carrello abbandonato.
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: 'My product',
description: 'product description',
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: '',
customField2: ''
}]
};
connectif.managed.sendEvents([
// here my events if any
], { entityInfo, cart });
Congratulazioni!
Hai raggiunto la fine della lezione.
Hai ancora dubbi?
Ricorda che hai a disposizione i nostri specialisti Connectif. Per contattarli, basta aprire un ticket al Support cliccando il pulsante blu “Aiuto” nella tua dashboard.
Continua a imparare!
Per sfruttare al massimo il potenziale del tuo account Connectif, ti consigliamo di proseguire con i seguenti articoli:
- Aggiungere il JavaScript Connectif al tuo sito, per inserire il codice e iniziare a raccogliere informazioni sulle visite alle tue pagine.
- 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 eCommerce, per assicurarti che tutti i dati siano sincronizzati correttamente nel tuo account Connectif.