Il tag “Acquisto effettuato" è un frammento di codice HTML che serve per descrivere un acquisto completato.
Questo articolo fa parte dei passaggi per creare un'integrazione personalizzata.
Se la tua integrazione avviene tramite modulo, questo tag verrà inserito automaticamente nel tuo eCommerce.
Qual è e dove usare questo tag?
Il tag “cn_purchase" deve essere inserito nella prima pagina visitata dopo un acquisto. Solitamente, questa pagina sarà quella di conferma dell'acquisto.
Proprietà
Le diverse proprietà di un acquisto devono essere definite all'interno del tag “cn_purchase" come tag figli, indicando il nome della proprietà nell'attributo “class".
Ogni prodotto diverso presente nel carrello è indicato con un tag con classe "product_basket_item", che include la quantità e l'importo.
Se desideri saperne di più sull’oggetto "Product Basket Item", consulta questo articolo.
Le proprietà da includere nel tag sono:
| Nome | Obbligatoria | Tipo | Multipli | Descrizione |
|---|---|---|---|---|
| total_quantity | Sì | intero | No | Quantità totale di prodotti nell'acquisto (inclusi i duplicati). Ad esempio: se un carrello ha 3 unità di un prodotto e 7 di un altro, total_quantity sarà 10. |
| total_price | Sì | decimale | No | Importo totale dell'acquisto. |
| payment_method | No | stringa | No | Metodo di pagamento utilizzato per l’acquisto. |
| purchase_date | No | stringa | No | Data e ora dell'acquisto. È previsto il formato ISO_8601, ad esempio 2024-09-13T10:49:31Z. |
| product_basket_item | No | Product Basket Item | Sì | Articoli inclusi nell'acquisto, con quantità e importo. |
| source_name | No | stringa | No | Nome della fonte, per fornire contesto o dettagli sul tipo di origine dell'acquisto. |
| source_type | No | stringa | No | Nome della fonte in cui è stato effettuato l'acquisto. I valori possibili sono: "marketplace", "digital-store", "point-of-sale", "third-party" e "other". |
| purchase_id | Sì | stringa | No | Identificativo univoco dell'acquisto. |
| cart_id | No | stringa | No | Identificativo univoco del carrello da cui ha avuto origine l'acquisto. |
Sebbene opzionale, si consiglia l'uso del campo "cart_id" per modificare lo stato del carrello in acquistato ed evitare eventi di Carrello abbandonato errati.
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
Una volta incluse le proprietà, il tag avrà questo aspetto:
<div class="cn_purchase " style="display:none">
<span class="cart_id">crt8679803</span>
<span class="purchase_id">prchs5241</span>
<span class="purchase_date">2017-09-29 14:12:37.430Z</span>
<span class="total_quantity">3</span>
<span class="total_price">180.75</span>
<span class="payment_method">Carta di credito</span>
<span class="source_type">digital-store</span>
<span class="source_name">My online store</span>
<div class="product_basket_item">
<span class="quantity">3</span>
<span class="price">180.75</span>
<span class="url">http://example.org/products/pr9658</span>
<span class="product_id">pr9658</span>
<span class="name">Tastiera Gaming Logitech Pro v.1.5</span>
<span class="description">Tastiera wireless retroilluminata di fascia alta, personalizzabile e resistente a liquidi e cadute.</span>
<span class="image_url">http://example.org/img/products/pr9658.jpg</span>
<span class="unit_price">60.25</span>
<span class="availability">InStock</span>
<span class="category">/Computer/Tastiere/Logitech</span>
<span class="category">/Computer/Gaming</span>
<span class="tag">Blu</span>
<span class="tag">Gaming</span>
<span class="tag">Retroilluminata</span>
<span class="tag">Wireless</span>
<span class="brand">Logitech</span>
<span class="review_count">9</span>
<span class="rating_value">4.5</span>
<span class="thumbnail_url">http://example.org/img/thumbnails/products/pr9658.jpg</span>
<span class="related_external_product_id">pr10636</span>
<span class="related_external_product_id">pr11939</span>
<span class="related_external_product_id">pr12653</span>
<span class="published_at">2020-05-20T15:24:20Z</span>
<span class="custom_field_1">Informazione personalizzata di esempio</span>
</div>
</div>
Complimenti!
Hai raggiunto la fine della lezione.
Hai ancora dei 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 tutto il potenziale del tuo account Connectif, ti consigliamo di proseguire con i seguenti articoli:
Integrazione tramite tag, per conoscere tutte le notifiche che puoi inviare dal tuo eCommerce a Connectif e come funzionano.
Integrazione tramite eventi JavaScript, per scoprire questo tipo di integrazione che ti consente un maggiore controllo su quando e come inviare gli eventi.
Integrazione con Connectif via API, per sincronizzare contatti, prodotti, acquisti e coupon.
Verificare l'integrazione con l'eCommerce, per assicurarti che tutti i dati siano correttamente sincronizzati nel tuo account Connectif.