L'oggetto "Product" è un frammento di codice HTML che serve per definire un prodotto dell'eCommerce.
Qual è e dove usare questo oggetto?
L'oggetto "product" deve essere inserito nei tag del prodotto visitato e del prodotto cercato. Inoltre, deve essere utilizzato, aggiungendo la quantità e il prezzo, nei tag del carrello e di acquisto effettuato, trasformandolo in un "product_basket_item".
Proprietà
Un oggetto "product" include le seguenti proprietà:
Nome | Obbligatoria | Tipo | Multipli | Descrizione |
---|---|---|---|---|
url | Sì | string | No | URL della pagina del prodotto (non codificato). |
product_id | Sì | string | No | Identificatore univoco del prodotto nel sistema. |
name | Sì | string | No | Nome del prodotto. |
unit_price | Sì | decimal | No | Prezzo unitario del prodotto. |
image_url | No | string | No | URL dell'immagine del prodotto. |
description | No | string | No | Descrizione del prodotto. |
availability | No | string | No | Può avere uno dei seguenti valori: InStock o OutOfStock. |
category | No | string | Sì | La categoria a cui appartiene il prodotto. Se il tuo sistema permette sotto-categorie, puoi indicarle con il percorso completo della categoria separando ogni livello con il carattere '/'. Per esempio: "/Computer/Tastiere/Logitech". |
tag | No | string | Sì | Le etichette associate al prodotto. |
brand | No | string | No | Marca del prodotto. |
review_count | No | integer | No | Numero di recensioni del prodotto. |
rating_value | No | decimal | No | Valutazione del prodotto normalizzata su una scala da 0 a 5. |
rating_count | No | integer | No | Numero totale delle valutazioni del prodotto. |
thumbnail_url | No | string | No | URL dell'immagine in miniatura del prodotto. |
related_external_product_id | No | string | Sì | ID dei prodotti correlati. |
priority | No | integer | No | Priorità di un prodotto. |
unit_price_original | No | decimal | No | Prezzo unitario originale del prodotto. |
unit_price_without_vat | No | decimal | No | Prezzo unitario del prodotto senza tasse. |
discounted_percentage | No | decimal | No | Percentuale di sconto, valore compreso tra 0 e 100 senza simbolo di percentuale. |
discounted_amount | No | decimal | No | Importo scontato del prodotto (dovrebbe corrispondere a unit_price_original - unit_price). |
published_at | No | datetime | No | Data di pubblicazione del prodotto nel catalogo del negozio in formato ISO 8601. Per esempio: "2020-05-20T15:12:20Z". |
custom_field_1 | No | string | No | Campo personalizzato del prodotto. |
custom_field_2 | No | string | No | Campo personalizzato del prodotto. |
custom_field_3 | No | string | No | Campo personalizzato del prodotto. |
Esempio:
Una volta incluso l'oggetto, il tag che lo contiene avrà questo aspetto:
<div class="cn_product_visited" style="display:none">
<span class="url">http://example.org/products/pr9633</span>
<span class="product_id">pr9633</span>
<span class="name">Monitor ASUS Gaming v.6.9 Full-HD</span>
<span class="description">Monitor per computer con ingresso HDMI ad alta definizione, ideale per il gaming.</span>
<span class="image_url">http://example.org/img/products/pr9633.jpg</span>
<span class="unit_price">260.95</span>
<span class="availability">OutOfStock</span>
<span class="category">/Computer/Monitor/Asus</span>
<span class="category">/Computer/Gaming</span>
<span class="tag">Nero</span>
<span class="tag">Gaming</span>
<span class="tag">Full-HD</span>
<span class="tag">HDMI</span>
<span class="brand">Asus</span>
<span class="review_count">215</span>
<span class="rating_value">3.9</span>
<span class="thumbnail_url">http://example.org/img/thumbnails/products/pr9633.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="priority">6</span>
<span class="unit_price_original">280.22</span>
<span class="unit_price_without_vat">240.67</span>
<span class="discounted_amount">15.32</span>
<span class="discounted_percentage">10</span>
<span class="rating_count">12</span>
<span class="published_at">2020-05-20T15:24:20Z</span>
<span class="custom_field_1">Informazione personalizzata di esempio</span>
</div>
Continua a imparare!
Per sfruttare al massimo il potenziale del tuo account su Connectif, ti consigliamo di continuare con i seguenti articoli:
- Integrazione tramite tag, per conoscere tutte le notifiche che puoi inviare dal tuo eCommerce a Connectif e il loro funzionamento.
- Integrazione tramite eventi JavaScript, per conoscere questo metodo di integrazione che ti permetterà un maggiore controllo su quando e come inviare gli eventi.
- Integración con Connectif vía API, para sincronizar contactos, productos, compras y cupones.
- Comprobar la integración con el eCommerce, para asegurarte de que todos los datos están sincronizándose de forma correcta en tu cuenta de Connectif.