# Prodotti, coupon e carrello

> Aggiungi alle email delle campagne e delle automazioni griglie di prodotti e prodotti consigliati, codici coupon unici, il carrello del contatto e i suoi dati di acquisto. Alpha: aperto solo al team di Emailit.

Con i prodotti e gli ordini del tuo negozio in Emailit (vedi [E-commerce](/it/docs/commerce/)), le email delle campagne e delle automazioni possono mostrare prodotti, dare a ogni destinatario il proprio codice coupon, elencare cosa c’è nel suo carrello e usare il suo storico degli acquisti. Ogni tag di questa pagina funziona nell’oggetto, nell’HTML e nella versione in testo semplice, e viene compilato per ogni destinatario quando viene creata l’email.

> **L’e-commerce è in alpha:** L’e-commerce è aperto solo al team di Emailit mentre lo testiamo. Vedi [Chi può usare l’e-commerce](/it/docs/commerce/#who-can-use-commerce).

## Aggiungi un blocco nell’editor

Nel passaggio **Content** della procedura guidata, seleziona **Products & coupons**. Scegli prodotti, un coupon, il carrello o i dati del cliente, regola le opzioni, seleziona **Copy** e incolla il tag nel contenuto. Negli editor di testo formattato e Dragit, anche il menu delle variabili elenca tag e-commerce pronti.

Il resto della pagina descrive i tag veri e propri, per l’editor HTML, l’API e i template delle automazioni.

## Griglie di prodotti

`{{products}}` inserisce una griglia di schede prodotto con un’immagine, il titolo, il prezzo (con il prezzo precedente barrato quando il prodotto è in saldo) e un pulsante:

```handlebars
{{products source="best_sellers" limit="3"}}
{{products source="recently_viewed" limit="4" fallback="best_sellers" button="View"}}
{{products "on_sale"}}
```

Una parola iniziale tra virgolette è la forma breve di `source`.

| Attributo | Predefinito | Significato |
| --- | --- | --- |
| `source` | `best_sellers` | Da dove provengono i prodotti, vedi sotto. |
| `limit` | `4` | Quanti prodotti, fino a 12. |
| `category` | | Con `source="category"`, la categoria. Con `best_sellers` o `newest`, li limita a quella categoria. |
| `ids` | | Con `source="ids"`, gli ID dei tuoi prodotti separati da virgole, nell’ordine in cui mostrarli. |
| `days` | `30` | Intervallo di tempo per `best_sellers` e `recently_viewed`, fino a 365. |
| `fallback` | | Una fonte valida per tutto il workspace da usare quando una fonte personale non trova nulla per un destinatario. |
| `columns` | 3, o meno se i prodotti sono meno | Schede per riga, da 1 a 4. |
| `button` | `Shop now` | Testo del pulsante. `button=""` nasconde il pulsante. |
| `button_color` | `#111111` | Colore del pulsante come codice esadecimale. |
| `show_price` | `true` | `false` nasconde i prezzi. |
| `show_description` | `false` | `true` aggiunge la descrizione del prodotto. |

I feed saltano i prodotti archiviati e quelli con giacenza pari a 0, tranne `last_order`.

### Fonti

| Fonte | Uguale per tutti | Prodotti |
| --- | --- | --- |
| `best_sellers` | Sì | Quelli con più unità vendute negli ultimi `days`. Completati con i prodotti più recenti quando le vendite non bastano. |
| `newest` | Sì | I prodotti aggiunti al catalogo più di recente. |
| `on_sale` | Sì | I prodotti con prezzo di confronto superiore al prezzo. |
| `category` | Sì | I più venduti di una `category`, poi i suoi prodotti più recenti. |
| `ids` | Sì | I prodotti che elenchi in `ids`. |
| `recently_viewed` | No | I prodotti che il destinatario ha visto sul tuo sito negli ultimi `days`, a partire dal più recente. Richiede lo [script di tracciamento](/it/docs/commerce/connect-your-shop/#the-tracking-script). |
| `recommended` | No | I più venduti nelle categorie che il destinatario ha visto o acquistato, senza ciò che ha già acquistato. In mancanza di dati usa i più venduti. |
| `bought_together` | No | I prodotti acquistati spesso insieme a ciò che il destinatario ha acquistato. |
| `last_order` | No | Gli articoli dell’ordine più recente del destinatario. |

### Il tuo layout

Per progettare tu le schede, scorri un feed con `{{#each}}`. All’interno del ciclo, usa i campi del prodotto:

```handlebars
{{#each products.recommended limit="3" fallback="best_sellers"}}
  <a href="{{url}}"><img src="{{image_url}}" alt="{{title}}" width="180"></a>
  <p>{{title}}: {{price_formatted}}{{#if on_sale}} <s>{{compare_at_price_formatted}}</s>{{/if}}</p>
{{/each}}
```

| Campo | Valore |
| --- | --- |
| `id`, `sku` | L’ID e lo SKU del tuo prodotto. |
| `title`, `description`, `brand` | Testi del prodotto. |
| `url`, `image_url` | Link alla pagina del prodotto e all’immagine. |
| `price`, `price_formatted` | Il prezzo come numero e formattato con la valuta, ad esempio `€139.00`. |
| `compare_at_price`, `compare_at_price_formatted` | Il prezzo precedente. |
| `on_sale` | `true` quando il prezzo di confronto è superiore al prezzo. |
| `currency`, `categories` | Codice della valuta e lista delle categorie. |
| `index`, `number` | La posizione nel ciclo, a partire da 0 e da 1. |

Usa `{{#if products.recently_viewed}}...{{/if}}` per mostrare una sezione solo quando un destinatario ha prodotti in un feed. I dati dei prodotti subiscono l’escaping HTML, quindi il titolo di un prodotto non può rompere l’email.

## Codici coupon

`{{coupon "key"}}` inserisce un codice del [coupon](/it/docs/commerce/coupons/) con quella chiave:

```handlebars
<p>Here's 10% off your next order: <strong>{{coupon "welcome10"}}</strong></p>
```

- Un coupon **unique codes** dà a ogni destinatario il proprio codice, preso dal suo pool. Un destinatario mantiene lo stesso codice in ogni email della stessa campagna o automazione, compresa la versione web.
- Un coupon **one code for everyone** inserisce il suo codice per tutti.
- Quando il pool di un coupon a codici unici è vuoto o il coupon è scaduto, i destinatari ricevono il suo codice di riserva, o niente se non ne ha uno.
- Le anteprime e le email di prova mostrano un esempio come `WELCOME10-PREVIEW` e non consumano codici.
- Una chiave sconosciuta non produce nulla.

`{{coupon.welcome10}}` è lo stesso codice come variabile, ad esempio in `{{#if coupon.welcome10}}`.

## Il carrello

`{{cart}}` inserisce il carrello aperto del destinatario: ogni articolo con immagine, quantità e prezzo, il totale e un pulsante **Return to your cart** che porta all’URL di checkout del carrello. Imposta `button` e `button_color` come nelle griglie di prodotti. Quando il destinatario non ha un carrello aperto, non produce nulla.

Per un layout tutto tuo, usa le variabili del carrello:

```handlebars
{{#if cart}}
  <p>You left {{cart.item_count}} items ({{cart.total_formatted}}) in your cart.</p>
  {{#each cart.items}}<p>{{quantity}} × {{title}}: {{line_total_formatted}}</p>{{/each}}
  <a href="{{cart.checkout_url}}">Complete your order</a>
{{/if}}
```

`cart` ha `id`, `total`, `total_formatted`, `currency`, `checkout_url`, `item_count` e `items`. Ogni articolo ha i campi del prodotto visti sopra, più `quantity`, `line_total` e `line_total_formatted`. Il carrello è il carrello attivo o abbandonato più recente del contatto, quindi in un’[automazione per il carrello abbandonato](/it/docs/automations/recipes/#abandoned-cart-reminder) è il carrello che è stato abbandonato.

## Dati del cliente

| Tag | Valore |
| --- | --- |
| `{{customer.orders_count}}` | Numero di ordini. |
| `{{customer.total_spent}}`, `{{customer.total_spent_formatted}}` | Totale speso, come numero e formattato. |
| `{{customer.average_order_value}}`, `{{customer.average_order_value_formatted}}` | Valore medio dell’ordine. |
| `{{customer.first_order_at}}`, `{{customer.last_order_at}}` | Date del primo e dell’ultimo ordine, `YYYY-MM-DD`. |
| `{{customer.expected_next_order_at}}` | Quando è previsto il prossimo ordine, a partire dal secondo ordine. |
| `{{customer.churn_risk}}` | `low`, `medium` o `high`, oppure vuoto senza ordini. |
| `{{customer.is_customer}}` | `true` quando il contatto ha effettuato ordini. |

```handlebars
{{#if customer.is_customer}}Thanks for being a customer since {{customer.first_order_at}}.{{else}}Your first order ships free.{{/if}}
```

## Versione web

`{{webview_url}}` porta a una versione web dell’email, elaborata per quel destinatario con gli stessi prodotti, carrello e codice coupon. Usalo per un link «Visualizza nel browser».

## Vedi anche

  - [E-commerce](/it/docs/commerce/): Collega il tuo negozio e guarda i ricavi delle email.
  - [Temple](/it/docs/templates/temple/): Variabili, valori di riserva e condizioni.

---
Fonte: https://emailit.com/it/docs/campaigns/products-and-coupons/