# E-commerce

> Invia a Emailit i prodotti, gli ordini e i carrelli del tuo negozio per vedere i ricavi portati dalle email, personalizzare i contenuti con prodotti e coupon e raggiungere acquirenti e carrelli abbandonati. Alpha: aperto solo al team di Emailit.

L’e-commerce collega il tuo negozio online a Emailit. Quando prodotti, ordini e carrelli sono in Emailit, puoi vedere quanti ricavi porta ogni campagna e automazione, inserire nelle email prodotti, codici coupon e carrelli, segmentare i contatti in base a ciò che acquistano e avviare automazioni quando qualcuno effettua un ordine o abbandona un carrello.

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

## Chi può usare l’e-commerce

Durante l’alpha, l’e-commerce è disponibile solo per gli amministratori della piattaforma Emailit. Il ruolo Admin di un workspace non basta.

| Dove | Team di Emailit | Tutti gli altri |
| --- | --- | --- |
| Pannello | **Email Marketing → Commerce**, i ricavi nei report delle campagne, i test A/B vinti in base agli ordini o ai ricavi, il selettore **Products & coupons**, i trigger di acquisto nelle automazioni, gli eventi e-commerce nei webhook e il riquadro **Purchases** dei contatti | **Commerce** nel menu mostra **Soon** e non si può aprire. Il resto è nascosto, ma una campagna o un’automazione che usa già una funzione e-commerce continua a mostrarla. |
| API e MCP | Le API dei prodotti, degli ordini, dei carrelli, dei coupon e dell’e-commerce, i ricavi nelle [statistiche delle campagne](/it/docs/api-reference/campaigns/stats/) e gli strumenti MCP dell’e-commerce | `403` con `error: "commerce_alpha"`. Le statistiche delle campagne omettono `commerce`. |
| Chiavi API e script di tracciamento | Funzionano nei workspace di proprietà di un amministratore della piattaforma Emailit. | `403` con `error: "commerce_alpha"`. I comandi `product`, `cart` e `purchase` dello script di tracciamento vengono rifiutati con lo stesso messaggio, e le visualizzazioni di pagina vengono ignorate. |

Le campagne e le automazioni che usano già una funzione e-commerce continuano a funzionare per tutti nel workspace.

## Cosa puoi fare

| Funzione | Dove |
| --- | --- |
| Ricavi dalle email, prodotti principali e campagne principali | **Email Marketing → Commerce** |
| Ricavi, ordini e tasso di conversione per campagna, e test A/B vinti in base ai ricavi | [Report delle campagne](/it/docs/campaigns/reports/), [Test A/B](/it/docs/campaigns/ab-testing/) |
| Griglie di prodotti, prodotti consigliati, codici coupon unici e carrello nelle email | [Prodotti, coupon e carrello](/it/docs/campaigns/products-and-coupons/) |
| Segmenti per ordini, spesa, rischio di churn, prodotti acquistati o visti, carrelli e coupon | [Segmenti](/it/docs/api-reference/segments/create/#activity-rules) (anch’essi in alpha) |
| Automazioni per carrelli abbandonati e nuovi ordini | [Trigger delle automazioni](/it/docs/automations/triggers/) |
| Far uscire gli acquirenti da una sequenza, o creare diramazioni in base a ciò che hanno acquistato | [Condizioni di uscita e obiettivi](/it/docs/automations/exits-and-goals/), [Condition (If/Else)](/it/docs/automations/steps/#condition-ifelse) |
| Un profilo acquisti su ogni contatto | La pagina del contatto nel pannello |

## Porta i dati del negozio in Emailit

| Dati | Come arrivano a Emailit |
| --- | --- |
| **Prodotti** | L’[API dei prodotti](/it/docs/api-reference/products/), oppure le visualizzazioni di prodotto dello script di tracciamento, che aggiungono i prodotti non ancora presenti nel catalogo. |
| **Ordini** | L’[API degli ordini](/it/docs/api-reference/orders/create/) dal backend del negozio, con una chiave con accesso completo o una chiave **Events Only**. Funziona anche il comando di acquisto dello script di tracciamento, ma i browser possono bloccarlo. |
| **Carrelli** | Lo script di tracciamento a ogni modifica del carrello, oppure l’[API dei carrelli](/it/docs/api-reference/carts/upsert/). |
| **Visualizzazioni di prodotto e attività sul sito** | Lo [script di tracciamento](/it/docs/events/tracking-script/) del [Tracciamento degli eventi](/it/docs/events/). |

[Collega il tuo negozio](/it/docs/commerce/connect-your-shop/) spiega l’API e lo script di tracciamento.

Un ordine con un indirizzo email che non è ancora un contatto crea il contatto. Il contatto non viene iscritto a nessuna lista, a meno che l’ordine non indichi che l’acquirente accetta il marketing, così le campagne non raggiungono gli acquirenti che non hanno dato il consenso.

## Come gli ordini vengono attribuiti alle email

Ogni nuovo ordine viene attribuito all’email di campagna o di automazione che l’acquirente ha **cliccato** per ultima entro la finestra dei clic prima dell’ordine (5 giorni per impostazione predefinita). Senza un clic, viene attribuito all’email che ha **aperto** per ultima entro la finestra delle aperture (1 giorno per impostazione predefinita). I clic prevalgono sulle aperture perché alcune app di posta caricano le immagini, e quindi registrano un’apertura, senza che nessuno legga l’email.

- La finestra parte dal clic o dall’apertura, non dall’invio dell’email: chi clicca una campagna di una settimana fa e acquista il giorno dopo viene conteggiato.
- I visitatori che arrivano da un link in un’email portano con sé un’identità firmata, quindi l’acquisto viene attribuito anche se avviene in un’altra sessione del browser, purché il clic sia nella finestra.
- Gli ordini importati con [`historical`](/it/docs/api-reference/orders/batch/) non vengono attribuiti alle email e non avviano automazioni.
- I ricavi sono il totale dell’ordine meno i rimborsi. Gli ordini annullati non contano.

Ogni ordine attribuito mostra **Credited to** con la campagna o l’automazione e se deriva da un clic o da un’apertura.

## Impostazioni

**Email Marketing → Commerce → Settings** contiene:

| Impostazione | Predefinito | Valori consentiti |
| --- | --- | --- |
| **Currency** | USD | Un codice di valuta di tre lettere, usato per gli ordini e i carrelli che non ne indicano una. |
| **Click window (days)** | 5 | Da 1 a 30. |
| **Open window (days)** | 1 | Da 0 a 30. Con 0 vengono attribuiti solo i clic. |
| **Cart abandoned after (minutes)** | 60 | Da 15 a 10.080. Il carrello di un contatto noto che resta invariato per questo tempo viene considerato abbandonato. |

La pagina delle impostazioni contiene anche gli snippet dello script di tracciamento e una richiesta di ordine di esempio. Con l’API, usa [Recupera le impostazioni e-commerce](/it/docs/api-reference/commerce/get-settings/) e [Aggiorna le impostazioni e-commerce](/it/docs/api-reference/commerce/update-settings/).

## Le pagine Commerce

- **Overview** mostra, per gli ultimi 7, 30 o 90 giorni: **Revenue**, **Revenue from email** (suddivisi tra campagne e automazioni), **Orders** con il valore medio dell’ordine, **Customers** (nuovi e abituali), i ricavi giornalieri, i carrelli (attivi, abbandonati, valore abbandonato e recuperati), **Top products** e **Top campaigns by revenue**. Gli importi sono per valuta, e la valuta principale è mostrata per prima.
- **Products**, **Orders**, **Carts** e **Coupons** elencano ciò che Emailit ha, con ricerca e filtri. Seleziona un ordine per vederne gli articoli e l’email a cui è attribuito.
- **Settings**, vedi sopra.

### Carrelli abbandonati

Un carrello diventa **Abandoned** quando appartiene a un contatto noto, contiene articoli e non è cambiato per il tempo di abbandono. Emailit genera allora l’evento [`cart.abandoned`](/it/docs/webhooks/events/cart/abandoned/), che può avviare un’[automazione per il carrello abbandonato](/it/docs/automations/recipes/#abandoned-cart-reminder). Un carrello diventa **Converted** quando un ordine lo indica con `cart_id`, o quando lo stesso contatto effettua un ordine.

### Profilo acquisti

Un contatto con ordini, carrelli o attività sul sito ha un riquadro **Purchases** nella sua pagina: ordini, totale speso, ordine medio, ultimo ordine, prossimo ordine previsto, ultima attività sul tuo sito, fuso orario, **Churn risk**, il carrello aperto, i prodotti visti di recente e gli ordini recenti.

**Expected next order** è l’ultimo ordine più l’intervallo medio tra gli ordini del contatto, a partire dal secondo ordine. Il **Churn risk** confronta il tempo trascorso dall’ultimo ordine con quell’intervallo (almeno 14 giorni), oppure con 90 giorni per chi ha acquistato una sola volta: **low** entro l’intervallo, **medium** fino al doppio, **high** oltre.

## Eventi

L’e-commerce registra ciò che succede nel tuo negozio come eventi di sistema, nello stesso posto di tutti gli altri eventi. Compaiono in **Email API → Events** (ambito **System**), nell’attività del contatto, nell’[API degli eventi](/it/docs/api-reference/events/list/), nei [webhook](/it/docs/webhooks/) e nelle automazioni:

| Evento | Quando |
| --- | --- |
| [`order.placed`](/it/docs/webhooks/events/order/placed/) | Un ordine viene salvato per la prima volta, tranne le importazioni storiche. Avvia le automazioni **Placed an order** e termina le esecuzioni con questa condizione di uscita. |
| [`order.updated`](/it/docs/webhooks/events/order/updated/) | Un ordine salvato cambia, ad esempio lo stato o un rimborso. |
| [`cart.updated`](/it/docs/webhooks/events/cart/updated/) | Un carrello viene creato, oppure cambiano i suoi articoli, il totale, lo stato o il contatto. Inviare di nuovo lo stesso carrello non lo genera. |
| [`cart.abandoned`](/it/docs/webhooks/events/cart/abandoned/) | Un carrello viene abbandonato. Un carrello che cambia e torna inattivo lo genera di nuovo. Avvia le automazioni **Abandoned a cart**. |
| [`product.viewed`](/it/docs/webhooks/events/product/viewed/) | Lo script di tracciamento registra una visualizzazione di prodotto, da un contatto o da un visitatore anonimo. |

`cart.updated` e `product.viewed` derivano dal traffico del sito, quindi un webhook con **All events** non li riceve. Sottoscrivili per nome, come gli [eventi di workspace e personalizzati](/it/docs/webhooks/event-types/#workspace-and-custom-events). Gli eventi e-commerce aggiornano anche, entro circa un minuto, i [segmenti tracciati](/it/docs/segments/tracked/) con regole su acquisti, carrelli o visualizzazioni di prodotto.

## Passaggi successivi

  - [Collega il tuo negozio](/it/docs/commerce/connect-your-shop/): Invia gli ordini dal backend e aggiungi lo script di tracciamento.
  - [Prodotti, coupon e carrello](/it/docs/campaigns/products-and-coupons/): Personalizza le email con il tuo catalogo.
  - [Coupon](/it/docs/commerce/coupons/): Codici unici per ogni destinatario.
  - [Modelli di automazione](/it/docs/automations/recipes/): Flussi per i carrelli abbandonati e i ringraziamenti.

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