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>
L'esempio precedente è incluso con il tag cn_product_visited.
L'URL del prodotto deve essere quello della scheda dettagliata del prodotto sul sito web e deve apparire senza alcuna codifica.
Congratulazioni!
Hai completato la lezione.
Hai ancora dubbi?
Ricorda che hai a disposizione i nostri specialisti di Connectif. Per contattarli, devi solo aprire un ticket di supporto facendo clic sul pulsante blu "Aiuto" nella tua dashboard.
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.