Notificare le informazioni del carrello

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.

  

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

 

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 string Identificatore univoco del carrello.
totalQuantity 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 number Prezzo totale del carrello.
products 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 number Quantità di unità di questo prodotto.
price 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: