Vai al contenuto
Docs

Riferimento

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.

Aggiornato il 1 ott 2026

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.
{{cf.<key>}} Il valore di un campo personalizzato, 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.

Tag di unione e Temple

Le campagne usano i propri tag di unione. I template inviati tramite l’API email e le email inviate dalle automazioni usano 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>}}.

Definisci i campi che usi nei tag di unione.
Variabili, valori di riserva e condizioni per gli invii via API.

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.