# Disiscrizioni

> Come le persone si disiscrivono dalle campagne, cosa fanno il link e gli header di disiscrizione, dove compaiono le disiscrizioni nei report e come gestire tu stesso gli opt-out.

Questa pagina spiega come i destinatari si disiscrivono dalle tue campagne, cosa aggiunge Emailit a ogni email di una campagna per permetterlo e come puoi vedere e modificare tu stesso gli opt-out. Spiega anche il rapporto tra disiscrizioni ed email transazionali.

## Tre modi per fermare una campagna

Prima di inviare un’email di una campagna, Emailit controlla tre cose. Ognuna è un tipo diverso di opt-out:

| Livello | Dove è memorizzato | Chi lo imposta | Cosa blocca |
| --- | --- | --- | --- |
| **Iscrizione alla lista** | L’iscritto (`subscribed: false`) | Il link di disiscrizione del destinatario, oppure tu | Le campagne inviate a quella lista. Il link di disiscrizione disattiva tutte le liste in cui si trova il contatto. |
| **Stato marketing** | Il contatto (`unsubscribed: true`) | Tu, dall’elenco dei contatti o con l’API | Le campagne inviate a qualsiasi lista. |
| **Soppressione** | La lista di soppressione | Bounce, segnalazioni, automazioni, oppure tu | Le campagne e, con il tipo `recipient`, anche tutte le altre email. Vedi [Soppressioni](/it/docs/suppressions/). |

## Link di disiscrizione nelle email delle campagne

### Header aggiunti per te

Ogni email di una campagna include questi header, con un link unico per il destinatario e la campagna:

```text
List-Unsubscribe: <unsubscribe link>
List-Unsubscribe-Post: List-Unsubscribe=One-Click
```

`List-Unsubscribe-Post` indica che il link è con un clic ([RFC 8058](https://www.rfc-editor.org/rfc/rfc8058)). Provider di posta come Gmail e Yahoo usano questi header per mostrare un proprio pulsante **Unsubscribe** accanto al nome del mittente, e se li aspettano dai mittenti di grandi volumi. Non devi aggiungere né configurare nulla.

### Il link nei contenuti

Inserisci anche un link di disiscrizione visibile in ogni campagna, con il tag di unione `{{unsubscribe_url}}`:

```html
<p>
  You're receiving this because you subscribed to Acme news.
  <a href="{{unsubscribe_url}}">Unsubscribe</a>
</p>
```

- Nell’editor **Dragit**, inseriscilo come link: `{{unsubscribe_url}}` è elencato tra i link speciali.
- Nell’editor **Rich-text**, digita `@` e scegli **Unsubscribe URL**.
- Nell’editor **HTML**, scrivi tu il tag, esattamente come `{{unsubscribe_url}}`, senza spazi tra le parentesi graffe.

Il passaggio **Send** della procedura guidata della campagna controlla la presenza del tag e mostra «Missing unsubscribe link!» quando non è nell’HTML. Emailit non blocca l’invio, ma le leggi antispam come CAN-SPAM e GDPR, e le regole di Gmail e Yahoo per i mittenti di grandi volumi, richiedono un link di disiscrizione funzionante nelle email di marketing.

Negli [invii di prova](/it/docs/campaigns/test-and-schedule/#send-a-test), il link punta a un indirizzo di test e non disiscrive nessuno.

## La pagina di disiscrizione

Quando un destinatario apre il proprio link di disiscrizione, Emailit mostra una pagina ospitata e lo disiscrive subito. Non serve un clic di conferma.

- **Lascia tutte le liste.** L’iscrizione del contatto viene disattivata in tutte le liste a cui appartiene, non solo in quelle a cui è stata inviata la campagna. Il contatto e il suo stato marketing non cambiano.
- **Può dire il motivo.** La pagina chiede «Tell us why you're unsubscribing» con le opzioni **Not interested**, **Too many emails**, **Never signed up**, **This is a spam** e **Other**. Rispondere è facoltativo.
- **Può annullare.** **Resubscribe** riattiva la sua iscrizione in tutte le liste a cui appartiene e mostra «Resubscribe successful!».

La pagina non offre un centro preferenze: le persone non possono scegliere in quali liste restare. Se ti serve, inserisci un link a una pagina del tuo sito e aggiorna le loro iscrizioni con l’API.

Ogni disiscrizione invia un evento `email.unsubscribed` e un evento [`subscriber.updated`](/it/docs/webhooks/events/subscriber/) per ogni lista. Una reiscrizione invia `email.resubscribed` e `subscriber.updated`. Ricevili con i [webhook](/it/docs/webhooks/) per sincronizzare gli opt-out con i tuoi sistemi. Vedi [Tipi di evento](/it/docs/webhooks/event-types/).

## Le disiscrizioni nei report delle campagne

Le disiscrizioni fatte tramite il link vengono registrate sulla campagna che lo ha inviato:

- Il riquadro **Unsubscribed** nella scheda **Overview** della campagna mostra il numero e la percentuale sulle email inviate.
- La scheda **Unsubscribes** le elenca una per una con **Email**, **First name**, **Last name**, **Reason**, **IP address** e **Unsubscribed At**. Puoi fare ricerche e filtrare per motivo o data.
- Il report PDF include la ripartizione **Unsubscribe reasons**.

La colonna **Reason** mostra il motivo registrato con la disiscrizione, se c’è. I motivi registrati compaiono come **Manual**, **Unsubscribe Link** o **Complaint**.

Le disiscrizioni che fai tu dal pannello o con l’API modificano l’iscrizione, ma non sono collegate a una campagna e non compaiono in questi report. Vedi [Report delle campagne](/it/docs/campaigns/reports/).

## Segnalazioni

Quando un destinatario segna come spam un’email di una campagna e il suo provider di posta lo comunica, lo stato dell’email diventa **Complained** e, con le impostazioni predefinite di soppressione automatica, l’indirizzo viene aggiunto alla lista di soppressione con il tipo `complaint`. Le campagne saltano gli indirizzi soppressi, quindi la persona non riceve altre campagne. Vedi [Bounce e segnalazioni di spam](/it/docs/deliverability/bounces-and-complaints/).

## Gestisci tu stesso gli opt-out

### Nel pannello

| Per | Fai così |
| --- | --- |
| Disiscrivere o reiscrivere qualcuno in una lista | Nella pagina del contatto, apri il menu della riga della lista e seleziona **Unsubscribe** o **Resubscribe**. Oppure, nella pagina della lista, seleziona **Edit** e cambia **Subscribed**. |
| Bloccare tutte le campagne verso alcuni contatti | In **Email Marketing → Contacts**, selezionali e usa **Actions > Unsubscribe**. **Resubscribe** annulla l’operazione. |
| Trovare tutti quelli che hanno fatto opt-out | Filtra l’elenco dei contatti per **Unsubscribed**, oppure filtra gli iscritti di una lista per **Subscribed**. |
| Bloccare tutte le email verso un indirizzo | Aggiungilo in **Email API → Suppressions** con il tipo `recipient`. |

### Con l’API

Per disiscrivere da una sola lista, aggiorna l’iscritto. Puoi usare l’indirizzo email al posto dell’ID `sub_`:

```bash
curl https://api.emailit.com/v2/audiences/aud_5hJ2kL8mNp4Qr/subscribers/ada@example.com \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "subscribed": false }'
```

Imposta lo stato marketing di un massimo di 100 contatti in una volta con l’[azione di massa](/it/docs/api-reference/contacts/bulk/) `unsubscribe` o `resubscribe`, oppure di un solo contatto con `unsubscribed` in [Aggiorna un contatto](/it/docs/api-reference/contacts/update/):

```bash
curl https://api.emailit.com/v2/contacts/bulk \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "action": "unsubscribe", "ids": ["con_2kq8Vt4xLm7Rz", "con_9fW3pQ1nBc6Yt"] }'
```

Per esportare gli opt-out, elenca i contatti con `unsubscribed=true` o gli iscritti con `subscribed=false`. Vedi [Elenca i contatti](/it/docs/api-reference/contacts/list/) ed [Elenca gli iscritti](/it/docs/api-reference/audiences/subscribers/list/).

## Email transazionali e disiscrizioni

Disiscrizioni e stato marketing controllano solo le campagne. Le email che invii con l’[API email](/it/docs/email-api/) o con [SMTP](/it/docs/smtp/), e le email inviate dalle [automazioni](/it/docs/automations/), raggiungono comunque le persone che si sono disiscritte. È voluto: ricevute, reimpostazioni della password e comunicazioni sull’account devono continuare a funzionare.

Mantieni questa separazione inviando su quei canali solo contenuti transazionali. Alcune cose da sapere:

- `{{unsubscribe_url}}` è un tag di unione delle campagne. Non viene compilato nelle email inviate con l’API, SMTP o dalle automazioni, e queste email non ricevono automaticamente gli header `List-Unsubscribe`.
- Se invii email di tipo marketing al di fuori delle campagne, includi un tuo link di disiscrizione e rispettalo, ad esempio [aggiungendo una soppressione](/it/docs/suppressions/manage/) quando qualcuno fa opt-out.
- Per bloccare tutte le email verso un indirizzo, transazionali comprese, aggiungi una soppressione con il tipo `recipient`.

> **Suggerimento:** Gestisci in giornata gli opt-out che ti arrivano per altre vie, ad esempio una risposta che chiede di essere rimossi. Disiscrivere il contatto o aggiungere una soppressione ha effetto immediato dalla campagna successiva.

## Vedi anche

  - [Tag di unione](/it/docs/campaigns/merge-tags/): Tutti i tag che puoi usare nelle campagne, compreso il link di disiscrizione.
  - [Soppressioni](/it/docs/suppressions/): Blocca un indirizzo per tutti gli invii.

---
Fonte: https://emailit.com/it/docs/audiences/unsubscribes/