# Crea una campagna

> Segui la procedura guidata in cinque passaggi, dalla scelta delle liste e del mittente al contenuto, al test e all’invio, e scopri esattamente chi riceve la campagna.

Questa guida segue passo per passo la procedura guidata delle campagne: la scelta dei destinatari, l’impostazione di mittente e oggetto, la scrittura del contenuto, il test e l’invio. Spiega anche chi riceve davvero la campagna e come fare le stesse cose con l’API.

## Prima di iniziare

- Il workspace deve avere l’accesso alla produzione. Fino ad allora, le campagne non si possono inviare. Vedi [Accesso alla produzione](/it/docs/workspaces/production-access/).
- Verifica il dominio da cui invierai. Vedi [Aggiungi un dominio](/it/docs/domains/add-a-domain/).
- Crea almeno una [lista](/it/docs/audiences/) con iscritti.
- Facoltativo: prepara un [template](/it/docs/templates/) da cui partire per il contenuto.

## Crea la campagna

In **Email Marketing → Campaigns**, seleziona **Add campaign**, compila il campo **Name** e seleziona **Create**. Il nome serve solo a te. La procedura guidata si apre sul primo passaggio.

I passaggi sono elencati a sinistra. Un segno di spunta indica quelli completati, e puoi tornare a qualsiasi passaggio. **Continue** salva il passaggio corrente e passa al successivo. Finché la campagna è una bozza, puoi uscire e riprenderla dall’elenco Campaigns.

## Passaggio 1: Recipients

Scegli a chi è destinata la campagna.

- **Audiences:** scegli una o più liste. Ogni opzione mostra quanti iscritti ha. Ne serve almeno una.
- **Exclude audiences:** facoltativamente, scegli le liste i cui iscritti devono essere esclusi.
- **Estimated recipients:** si aggiorna quando cambi la selezione. Conta i contatti unici iscritti ad almeno una lista selezionata, meno quelli iscritti a una lista esclusa.

Seleziona **Continue** per salvare i destinatari.

### Chi riceve davvero la campagna

Emailit determina l’elenco definitivo quando inizia l’invio, non quando scegli le liste. Un contatto riceve la campagna quando:

1. È iscritto ad almeno una delle liste selezionate.
2. Il suo stato marketing è **Subscribed**. I contatti disiscritti con l’azione di massa **Unsubscribe** o con `unsubscribed: true` vengono saltati.
3. Il suo indirizzo non è nella [lista di soppressione](/it/docs/suppressions/), con qualsiasi tipo di soppressione non scaduta.

Ogni indirizzo riceve una sola copia, anche se si trova in più liste selezionate. Le persone che entrano in una lista dopo che hai programmato la campagna vengono incluse, e quelle che si disiscrivono prima dell’inizio dell’invio vengono escluse.

La stima non sottrae i contatti disiscritti a livello globale né gli indirizzi soppressi, quindi il numero di email inviate può essere inferiore alla stima.

> **Le liste escluse non vengono applicate all’invio:** Le liste escluse riducono la stima, ma la versione attuale non le applica quando la campagna viene inviata. Un contatto che si trova sia in una lista selezionata sia in una lista esclusa riceve comunque la campagna. Finché la situazione non cambia, non affidarti a **Exclude audiences** per escludere delle persone: rimuovile dalle liste selezionate, disiscrivile o invia a una lista che non le contiene.

## Passaggio 2: Sender and Subject

| Campo | Obbligatorio | Note |
| --- | --- | --- |
| **From name** | Sì | Il nome che vedono i destinatari, ad esempio `Acme`. |
| **From email** | Sì | Un indirizzo su un dominio verificato in questo workspace, ad esempio `news@acme.com`. |
| **Subject** | Sì | Può contenere [tag di unione](/it/docs/campaigns/merge-tags/), ad esempio `October news for {{first_name}}`. |
| **Reply to** | No | Dove arrivano le risposte. Lascialo vuoto per usare il **From email**. |

Seleziona **Continue** per salvare.

## Passaggio 3: Content

Scegli come vuoi scrivere l’email:

| Opzione | Ideale per |
| --- | --- |
| **Dragit editor** | Progettare un layout con blocchi drag and drop. Salva automaticamente mentre lavori. |
| **Rich-text editor** | Email semplici, basate sul testo. Digita `@` per inserire un tag di unione. |
| **HTML editor** | Incollare o scrivere il tuo HTML. |
| **Choose from templates** | Partire da uno dei tuoi [template](/it/docs/templates/). Emailit copia il contenuto del template nella campagna, quindi le modifiche successive non cambiano il template. L’oggetto del template non viene copiato. |

Vedi [Editor](/it/docs/templates/editors/) per il funzionamento di ciascun editor.

Quando la campagna ha un contenuto, il passaggio mostra un’anteprima con questi pulsanti:

- **Open editor** riapre l’editor che hai usato.
- **Remove content** cancella il contenuto, così puoi scegliere un altro editor. Cambiare editor parte sempre da un contenuto vuoto.
- **Save as template** salva il contenuto, l’oggetto e il mittente come nuovo template, da riusare in altre campagne o da inviare con l’API. Compila i campi **Name** e **Alias**, poi seleziona **Save** o **Save & Open**.

Aggiungi `{{unsubscribe_url}}` come link nel contenuto. In Dragit è elencato tra i link speciali, e nell’editor di testo formattato è la variabile **Unsubscribe URL**. Vedi [Disiscrizioni](/it/docs/audiences/unsubscribes/#the-link-in-your-content).

Seleziona **Continue** quando il contenuto è pronto.

## Passaggio 4: Preview and test

- **Desktop** e **Mobile** mostrano l’email con ciascuna larghezza.
- **Preview as contact** compila i tag di unione con il nome, l’email e i campi personalizzati di un contatto reale. Cerca un contatto per nome o email.
- **Send test** invia l’email a un massimo di 5 indirizzi.

Vedi [Testa e programma una campagna](/it/docs/campaigns/test-and-schedule/) per i dettagli e i limiti. Seleziona **Continue** quando il risultato ti soddisfa.

## Passaggio 5: Send

L’ultimo passaggio riepiloga **From**, **Reply to**, **Subject**, **Recipients** e **Content**, con un link **Edit** per tornare a ciascun passaggio, ed esegue questi controlli:

| Controllo | Risultato |
| --- | --- |
| **From**, **Subject**, **Content** | Devono essere superati. **Send campaign** resta disattivato finché non sono impostati tutti e tre. |
| Link di disiscrizione | «No problems detected!» quando l’HTML contiene `{{unsubscribe_url}}`. Altrimenti «Missing unsubscribe link!». Non blocca l’invio, ma correggilo prima di inviare. |
| Dimensione | «Your content will be clipped as it is bigger than 100kb.» compare quando l’HTML supera circa 102 KB. Gmail taglia i messaggi più lunghi e nasconde il resto, compresi il footer e il link di disiscrizione, dietro un link. Accorcia il contenuto o sposta immagini e stili fuori dall’HTML. |

Seleziona **Send campaign**, poi scegli:

- **Immediately**, poi **Send now**, per iniziare subito l’invio.
- **Schedule**, poi scegli data e ora in **Schedule for**, nel fuso orario del tuo computer, e seleziona **Schedule**. L’orario deve essere nel futuro.

Si apre la pagina della campagna, che risulta **In process** o **Scheduled**. Vedi [Testa e programma una campagna](/it/docs/campaigns/test-and-schedule/) per cosa succede dopo.

## Verifica che funzioni

- L’elenco Campaigns mostra la campagna in **In process** o **Scheduled**, poi in **Sent**.
- La pagina della campagna mostra una barra **Send progress** mentre le email vengono create, poi i conteggi di consegne ed engagement. Vedi [Report delle campagne](/it/docs/campaigns/reports/).
- Ogni email dei destinatari compare in **Email API → Emails** con il proprio stato.

## Crea una campagna con l’API

Gli stessi passaggi con l’[API delle campagne](/it/docs/api-reference/campaigns/), usando una chiave API con **Full Access**:

1. **Crea la bozza** con mittente, oggetto e HTML.

```bash
curl https://api.emailit.com/v2/campaigns \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "October newsletter",
    "from_name": "Acme",
    "from_email": "news@acme.com",
    "reply_to": "support@acme.com",
    "subject": "October news for {{first_name}}",
    "html": "<p>Hi {{first_name}},</p><p>Here is what is new.</p><p><a href=\"{{unsubscribe_url}}\">Unsubscribe</a></p>",
    "text": "Hi {{first_name}}, here is what is new. Unsubscribe: {{unsubscribe_url}}"
  }'
```

   La risposta contiene l’`id` della campagna, ad esempio `cmp_4Tq9Xv2kLm8Rw`, con `status` `draft`.

2. **Imposta i destinatari** con [Aggiorna una campagna](/it/docs/api-reference/campaigns/update/). `recipients` sostituisce la lista attuale e richiede almeno una lista di iscritti.

```bash
curl https://api.emailit.com/v2/campaigns/cmp_4Tq9Xv2kLm8Rw \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "recipients": [{ "audience_id": "aud_5hJ2kL8mNp4Qr" }] }'
```

3. **Inviala** con [Invia o programma una campagna](/it/docs/api-reference/campaigns/send/), oppure programmala con `scheduled_at`. Vedi [Testa e programma una campagna](/it/docs/campaigns/test-and-schedule/#use-the-api).

```bash
curl https://api.emailit.com/v2/campaigns/cmp_4Tq9Xv2kLm8Rw/send \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY"
```

## Vedi anche

  - [Tag di unione](/it/docs/campaigns/merge-tags/): Personalizza l’oggetto e il contenuto.
  - [Testa e programma una campagna](/it/docs/campaigns/test-and-schedule/): Email di prova, programmazione e annullamento.

---
Fonte: https://emailit.com/it/docs/campaigns/create/