# Coupon

> Dai a ogni destinatario delle email il proprio codice sconto monouso, oppure un solo codice per tutti, e scopri quali codici sono stati assegnati e utilizzati. Alpha: aperto solo al team di Emailit.

Un coupon inserisce un codice sconto nelle tue email con `{{coupon "key"}}`. Un coupon **unique codes** assegna a ogni destinatario il proprio codice preso da un pool, così i codici non si possono condividere. Un coupon **one code for everyone** inserisce lo stesso codice per tutti. Emailit distribuisce i codici; è il tuo negozio a verificarli al checkout, quindi crea gli stessi codici nel negozio.

> **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).

## Crea un coupon

1. **Apri Coupons.** In **Email Marketing → Commerce**, apri la scheda **Coupons** e seleziona **Create coupon**.

2. **Compila il coupon.**

   | Campo | Note |
   | --- | --- |
   | **Name** | Per te, ad esempio `Welcome 10%`. |
   | **Key** | Ciò che scrivi nel contenuto: `{{coupon "welcome10"}}`. Lettere minuscole, cifre, `-` e `_`, fino a 64 caratteri. Un contenuto che usa una chiave vecchia non produce nulla, quindi non cambiarla dopo che il coupon è in uso. |
   | **Type** | **Unique codes** o **One code for everyone**. |
   | **Code** | Per un coupon con un solo codice per tutti, il codice. |
   | **Fallback code** | Per i codici unici, facoltativo: viene inviato quando i codici finiscono o il coupon è scaduto. Senza, in questi casi il tag non produce nulla. |
   | **Discount** | Un’etichetta come `10% off`, mostrata nel pannello. |
   | **Expires** | Facoltativo. Dopo questa data, i coupon a codici unici inviano solo il codice di riserva. |

3. **Aggiungi i codici** a un coupon a codici unici. Aprilo e seleziona **Add codes**, poi scegli una delle due opzioni:
   - **Upload codes** dal tuo negozio: un codice per riga, oppure un CSV con i codici nella prima colonna, fino a 10.000 alla volta. I codici già presenti nel pool vengono saltati.
   - **Generate codes**: Emailit crea codici casuali senza caratteri che si somigliano (niente 0, O, 1 o I), con un prefisso facoltativo. Poi seleziona **Export CSV** e crea gli stessi codici nel negozio.

4. **Usalo nel contenuto.** Inserisci `{{coupon "welcome10"}}` in un’email di campagna o di automazione. Vedi [Prodotti, coupon e carrello](/it/docs/campaigns/products-and-coupons/#coupon-codes).

## Come vengono distribuiti i codici

- Ogni destinatario riceve un codice per campagna o automazione. Se la stessa email viene elaborata di nuovo per lui, ad esempio nella versione web, riceve lo stesso codice.
- I codici vengono assegnati quando viene creata l’email, quindi una campagna grande usa tanti codici quanti sono i suoi destinatari. Mantieni il pool più grande dei destinatari.
- Le anteprime e le email di prova mostrano un codice di esempio come `WELCOME10-PREVIEW` e non consumano codici.

## Traccia gli utilizzi

Quando un [ordine](/it/docs/api-reference/orders/create/) elenca un codice in `coupon_codes`, Emailit lo contrassegna come **Redeemed** con l’ordine. Un codice usato nel tuo negozio prima che Emailit lo distribuisse non viene mai inviato. La pagina del coupon mostra quanti codici sono **Available**, **Assigned** e **Redeemed**, ed elenca i codici con chi li ha ricevuti e quando. **Export CSV** scarica l’elenco.

I segmenti possono trovare i contatti che hanno usato un coupon con la regola `used_coupon`. Vedi [Regole di attività](/it/docs/api-reference/segments/create/#activity-rules).

## Usa l’API

| Endpoint | A cosa serve |
| --- | --- |
| [Crea un coupon](/it/docs/api-reference/coupons/create/) | Creare un coupon a codici unici o statico. |
| [Aggiungi codici a un coupon](/it/docs/api-reference/coupons/add-codes/) | Caricare codici, oppure generarli indicando quantità, prefisso e lunghezza. |
| [Elenca i codici di un coupon](/it/docs/api-reference/coupons/list-codes/) | Leggere il pool, filtrato per codici disponibili, assegnati o utilizzati. |
| [Elenca](/it/docs/api-reference/coupons/list/), [recupera](/it/docs/api-reference/coupons/get/), [aggiorna](/it/docs/api-reference/coupons/update/) ed [elimina](/it/docs/api-reference/coupons/delete/) | Gestire i coupon. |

## Vedi anche

  - [Prodotti, coupon e carrello](/it/docs/campaigns/products-and-coupons/): Tutti i tag e-commerce per il contenuto delle email.
  - [E-commerce](/it/docs/commerce/): Collega il tuo negozio e guarda i ricavi delle email.

---
Fonte: https://emailit.com/it/docs/commerce/coupons/