1. Centro assistenza
  2. Integra il tuo Negozio
  3. Integrazione personalizzata
  4. Tramite eventi JavaScript
  5. Notifica l'invio degli eventi JavaScript

Notificare evento di acquisto effettuato

Creato
Aggiornato
Segui

L’ evento “Notificare evento di acquisto completato” serve a descrivere un acquisto effettuato dal cliente. Per fare ciò, viene notificato, tramite JavaScript, quando un utente effettua un acquisto tramite l’uso di connectif.managed.sendEvents.

  

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

 

Come si usa

La notifica delle informazioni del carrello utilizza l’opzione entityInfo del metodo sendEvents,  per arricchire le informazioni degli eventi inviati.

  

Questo evento rappresenta un’alternativa all’implementazione del tag “Acquisto effettuato” nell’HTML della pagina del tuo negozio o sito web.

 

Notificare l’acquisto effettuato

Questo oggetto rappresenta il modello del Carrello d’acquisto che include le seguenti proprietà:

Nome Obbligatoria Tipo Descrizione
purchaseId Sì string Identificativo unico dell’acquisto.
cartId No string Identificativo unico del carrello da cui ha avuto origine questo acquisto.
totalQuantity Sì number Quantità totale di prodotti nell’acquisto (inclusi duplicati).
Per esempio: se un carrello contiene 3 unità di un prodotto e 7 di un altro, totalQuantity sarà 10.
totalPrice Sì number Importo totale dell’acquisto.
purchaseDate No string Data dell’acquisto. Si aspetta formato ISO_8601.
paymentMethod No string Metodo di pagamento.
products Sì Product Basket Item Prodotti inclusi nell’acquisto, insieme alla quantità degli stessi e al prezzo.
source_name No string Il nome della fonte, per fornire contesto o dettagli sul tipo di origine dell’acquisto.
source_type No string

Il nome della fonte in cui è stato effettuato l’acquisto. I valori possibili sono: "marketplace", "digital-store", "point-of-sale", "third-party" e "other".
 

Anche se opzionale, il campo cartId è fortemente raccomandato per poter segnalare il carrello come acquistato ed evitare eventi errati di Carrello Abbandonato.

 

Organizzazione dei valori della fonte (source_type)

Di seguito sono spiegati ciascuno dei possibili valori della fonte dell’acquisto (source_type):

Valore Descrizione Esempio
third-party Vendite instradate tramite distributori, rivenditori o reti di partner (non marketplaces).

Ingrosso, Distributori, Affiliati...
other Casi particolari o canali speciali che non rientrano nelle categorie sopra.

Vendite telefoniche, Fiere ed eventi, Commercio sociale...
marketplace Piattaforme eCommerce di terzi dove pubblichi i tuoi prodotti.

Amazon Marketplace, eBay, Zalando...
digital-store Vendite dal sito web o dall'app eCommerce del rivenditore.

Diretto, Ricerca organica, Ricerca a pagamento, Email Marketing...
point-of-sale Vendite nei negozi fisici elaborate tramite un sistema POS.

Checkout in negozio, Chiosco in negozio, Negozi pop‑up...

 

Esempio

La notifica avrà questo aspetto:

connectif.managed.sendEvents([
    {
        "type": "purchase",
        "purchase": {
            "cartId": "cart-0098caf9-42f4-44e9-afdd-45eafe892293",
            "totalQuantity": 1,
            "totalPrice": 51.88,
            "products": [{
                "name": "My Product",
                "productDetailUrl": "https://myshop.com/product/details/59a31949a1a562d4979fbca2",
                "productId": "59a31949a1a562d4979fbca2",
                "unitPrice": 51.88,
                "availability": "outofstock",
                "imageUrl": "https://myshop.com/img/59a31949a1a562d4979fbca2.jpg",
                "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit.",
                "priority": 10,
                "rating": 4,
                "tags": ["tag1", "tag2", "tag3"],
                "relatedExternalProductIds": ["59a31953a1a562d4979fbd90", "59a31b2ba1a562d4979fe5b8"],
                "brand": "Jata",
                "publishedAt": "2020-05-03T10:15:00Z",
                "quantity": 1,
                "price": 51.88
            }],
            "purchaseId": "purchase-e3418b5a-8709-4593-a7c8-d8a7f12df737",
            "purchaseDate": "2020-06-26T12:52:51.591Z",
            "paymentMethod": "Credit Card" 
            "source_type": "digital-store"
            "source_name": "My online store"
        }
    },
    {
        "type": "page-visit"
    }], { entityInfo });
  

Normalmente la registrazione dell’acquisto viene notificata con l’evento di visita pagina. Questo evento rappresenta solitamente la visita alla pagina di conferma dell’ordine o dell’acquisto.

 

 

Complimenti!
Hai raggiunto la fine della lezione.

  

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

Continua a imparare!

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