# Tag di unione

> Personalizza oggetto e contenuto delle campagne con i tag di unione per nomi, email, campi personalizzati e link di disiscrizione, e scopri in cosa differiscono da Temple.

I tag di unione inseriscono in una campagna i dati di ciascun destinatario: il suo nome nell’oggetto, un campo personalizzato nel corpo e il suo link di disiscrizione personale. Questa pagina elenca tutti i tag, le regole di sintassi e come vedere il risultato in anteprima.

## Tag disponibili

| Tag | Sostituito con |
| --- | --- |
| `{{first_name}}` | Il nome del contatto. |
| `{{last_name}}` | Il cognome del contatto. |
| `{{email}}` | L’indirizzo email del contatto. |
| `{{unsubscribe_url}}` | Il link di disiscrizione personale del destinatario. Vedi [Disiscrizioni](/it/docs/audiences/unsubscribes/). |
| `{{cf.<key>}}` | Il valore di un [campo personalizzato](/it/docs/contacts/custom-fields/), indicato dalla sua chiave. Ad esempio, `{{cf.company}}` per un campo con chiave `company`. |

I tag di unione funzionano nel campo **Subject** della campagna, nel contenuto HTML e nella versione in testo semplice. Non vengono sostituiti in **From name**, **From email** e **Reply to**.

```html
<p>Hi {{first_name}},</p>
<p>Your {{cf.plan}} plan now includes scheduled sending.</p>
<p><a href="{{unsubscribe_url}}">Unsubscribe</a> from Acme emails sent to {{email}}.</p>
```

## Inserisci i tag negli editor

- **Editor di testo formattato:** digita `@` e scegli una variabile, o un campo personalizzato per nome.
- **Editor Dragit:** usa il menu dei campi di unione, che elenca First name, Last name, Email e i tuoi campi personalizzati. Il link di disiscrizione si trova tra i link speciali.
- **Editor HTML** e campo **Subject**: digita il tag.

## Regole di sintassi

- **Nessuno spazio dentro le parentesi graffe.** Scrivi `{{first_name}}`. Un tag con spazi, come `{{ first_name }}`, non viene sostituito e compare nell’email così come l’hai scritto. Questo conta soprattutto per il link di disiscrizione: il controllo del passaggio **Send** accetta `{{ unsubscribe_url }}`, ma solo `{{unsubscribe_url}}` diventa un link funzionante.
- **I nomi dei tag non distinguono tra maiuscole e minuscole**, quindi funziona anche `{{First_Name}}`. Le chiavi dei campi personalizzati devono corrispondere esattamente alla chiave salvata, e le chiavi sono sempre in minuscolo: scrivi `{{cf.company}}`, non `{{cf.Company}}`.
- **I campi personalizzati richiedono il prefisso `cf.`.** `{{company}}` non è un tag di unione e compare così come l’hai scritto.
- **Qualsiasi altra cosa tra doppie parentesi graffe resta com’è.** Emailit sostituisce solo i tag della tabella qui sopra.

## Valori mancanti

Quando un contatto non ha un valore per un tag, il tag viene sostituito con niente. Nelle campagne non c’è una sintassi per i valori di riserva: `{{first_name|"there"}}` non è supportato e compare così come l’hai scritto.

| Contenuto | Contatto con il nome | Contatto senza nome |
| --- | --- | --- |
| `Hi {{first_name}},` | Hi Ada, | Hi , |
| `Hi there,` | Hi there, | Hi there, |

Quindi scrivi un testo che funzioni anche senza il valore, oppure assicurati che tutti ne abbiano uno. Nell’elenco Contacts, filtra per **First name** con **is empty** per trovare i contatti senza nome.

## Come vengono resi i valori

| Tipo di campo | Reso come |
| --- | --- |
| Text, Number | Il valore salvato, ad esempio `Acme` o `42`. |
| Date | `YYYY-MM-DD`, ad esempio `1990-04-12`. |
| Boolean | `true` o `false`. |
| Select | L’opzione selezionata. |
| Multi select | Le opzioni separate da virgole, senza spazi, ad esempio `news,offers`. |

I valori vengono inseriti esattamente come sono salvati, senza escape HTML. Se le persone possono inserire i propri nomi, ad esempio tramite un modulo di iscrizione pubblico, controlla quei valori prima di usarli nell’HTML.

## Anteprima dei tag di unione

- **Preview as contact**, nel passaggio **Preview and test**, elabora l’oggetto e il contenuto con i dati di un contatto reale. Usalo per controllare nomi, campi personalizzati e valori vuoti.
- **Le email di prova** compilano `{{email}}` con l’indirizzo di prova e lasciano vuoti nomi e campi personalizzati. Il link di disiscrizione in un’email di prova non disiscrive nessuno.

Vedi [Testa e programma una campagna](/it/docs/campaigns/test-and-schedule/).

## Tag di unione e Temple

Le campagne usano i propri tag di unione. I template inviati tramite l’[API email](/it/docs/email-api/) e le email inviate dalle [automazioni](/it/docs/automations/) usano [Temple](/it/docs/templates/temple/), il linguaggio di template di Emailit, che ha un aspetto simile ma funziona in modo diverso:

| | Tag di unione delle campagne | Temple |
| --- | --- | --- |
| Usato in | Campagne | Invii via API e SMTP con un template, email delle automazioni |
| Dati | Il contatto destinatario | Le `variables` che passi, oppure i dati del contatto e dell’evento dell’esecuzione dell’automazione |
| Insieme fisso di tag | Sì, i cinque tag qui sopra | No, qualsiasi variabile che passi |
| Valori annidati | Solo `cf.<key>` | Qualsiasi percorso, come `{{user.name}}` |
| Valori di riserva | No | Sì |
| Condizioni | No | Sì, `{{#if ...}}` |
| Link di disiscrizione | `{{unsubscribe_url}}` | Non fornito |

In Temple, il valore di riserva va dopo una barra verticale, ad esempio `{{first_name|"there"}}`. Se salvi una campagna come template e la invii con l’API, Temple compila i tag con le `variables` che passi. Passa `first_name` per `{{first_name}}`, un oggetto `cf` per `{{cf.company}}` e un tuo `unsubscribe_url` se il contenuto rimanda a uno. Nelle automazioni, i campi personalizzati del contatto sono disponibili come `{{custom_fields.<key>}}`, non come `{{cf.<key>}}`.

## Vedi anche

  - [Campi personalizzati](/it/docs/contacts/custom-fields/): Definisci i campi che usi nei tag di unione.
  - [Temple](/it/docs/templates/temple/): Variabili, valori di riserva e condizioni per gli invii via API.

---
Fonte: https://emailit.com/it/docs/campaigns/merge-tags/
