Vai al contenuto
Docs

Riferimento

Personalizza oggetto e contenuto delle campagne con i tag di unione per nomi, email, campi personalizzati, link di disiscrizione e link di gestione delle iscrizioni, con i valori di riserva e le condizioni di Temple.

Aggiornato il 20 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 i suoi link personali di disiscrizione e di gestione delle iscrizioni. Le campagne li elaborano con Temple, il linguaggio di template di Emailit, quindi puoi aggiungere anche valori di riserva e blocchi condizionali. 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.
{{manage_subscriptions_url}} Il link del destinatario alla pagina di gestione delle iscrizioni, dove sceglie le sue liste. Vuoto negli invii di prova.
{{cf.<key>}} Il valore di un campo personalizzato, indicato dalla sua chiave. Ad esempio, {{cf.company}} per un campo con chiave company.
{{global.<key>}} Un valore globale del workspace, come {{global.offer_url}}. È lo stesso per tutti i destinatari.
{{tags}} I tag del contatto, come vip, customer. {{#if tags}}…{{/if}} controlla che il contatto ne abbia almeno uno.
{{score}} Il lead score del contatto.
{{webview_url}} Un link alla versione web dell’email, elaborata per quel destinatario.

Con l’e-commerce, in alpha per il team di Emailit, le campagne hanno anche tag per prodotti, codici coupon, carrello e dati di acquisto. Vedi Prodotti, coupon e carrello.

I campi personalizzati funzionano anche come {{custom_fields.<key>}}, la forma che usano le automazioni, e ogni tag è disponibile anche sotto contact, ad esempio {{contact.first_name}}.

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. I link di disiscrizione e di gestione delle iscrizioni si trovano tra i link speciali.
  • Editor HTML e campo Subject: digita il tag.

Regole di sintassi

  • Gli spazi intorno al nome di un tag vengono ignorati, quindi {{ first_name }} funziona come {{first_name}}. I blocchi condizionali sono più rigidi: scrivi {{else}} e {{/if}} esattamente come mostrato, e inizia una condizione con {{#if, senza spazi dopo le parentesi graffe.
  • I nomi dei tag non distinguono tra maiuscole e minuscole, quindi funziona anche {{First_Name}}. Questo vale per i sei tag della tabella e per il prefisso cf.. 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 percorsi sotto contact e custom_fields distinguono tra maiuscole e minuscole.
  • I campi personalizzati richiedono un prefisso. Scrivi {{cf.company}}: {{company}} non è un tag di unione, quindi diventa vuoto.
  • Qualsiasi altra cosa tra doppie parentesi graffe viene rimossa. Temple tratta ogni {{…}} come un segnaposto, e un segnaposto senza valore diventa vuoto. Non esiste una sintassi di escape: per mostrare doppie parentesi graffe letterali nell’HTML, scrivile come &#123;&#123;.

Valori mancanti

Quando un contatto non ha un valore per un tag, il tag viene sostituito con niente. Aggiungi dopo una barra verticale un valore di riserva da usare al suo posto. Un campo vuoto conta come mancante, quindi riceve anch’esso il valore di riserva.

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

Intorno al valore di riserva funzionano le virgolette doppie, quelle singole o nessuna virgoletta. Nell’elenco Contacts, filtra per First name con is empty per trovare i contatti senza nome.

Contenuto condizionale

Mostra un blocco solo ai contatti che hanno un valore, con un {{else}} facoltativo per tutti gli altri:

HTML
{{#if cf.plan}}
<p>Your {{cf.plan}} plan now includes scheduled sending.</p>
{{else}}
<p>Upgrade to get scheduled sending.</p>
{{/if}}

Una condizione è falsa quando il campo manca o è vuoto, false o 0, e vera in tutti gli altri casi. Non esistono confronti come cf.plan == "Pro": per rivolgerti a un solo valore, salvalo in un campo a sé, ad esempio un campo Boolean is_pro. I blocchi si possono annidare. Per le regole complete, vedi Condizioni.

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 inviate a un indirizzo che appartiene a un contatto di questo workspace usano i dati di quel contatto. Per gli altri indirizzi, {{email}} viene compilato con l’indirizzo di prova e nomi e campi personalizzati restano vuoti, quindi compaiono i valori di riserva e i blocchi {{else}}. Il link di disiscrizione in un’email di prova non disiscrive nessuno.

Vedi Testa e programma una campagna.

Tag di unione e Temple

I tag di unione delle campagne sono segnaposto di Temple compilati con i dati del contatto destinatario. Anche i template inviati tramite l’API email e le email inviate dalle automazioni usano Temple, con dati diversi:

Campagne Invii via API Email delle automazioni
Dati Il contatto destinatario Le variables che passi Il contatto, i dati dell’evento e i metadati dell’esecuzione
Campi personalizzati {{cf.<key>}} o {{custom_fields.<key>}} Quello che passi, ad esempio un oggetto cf {{cf.<key>}} o {{custom_fields.<key>}}
Link di disiscrizione e di gestione {{unsubscribe_url}}, {{manage_subscriptions_url}} Non forniti {{unsubscribe_url}}, {{manage_subscriptions_url}} nelle automazioni di tipo Contact
Maiuscole e minuscole nei nomi dei tag Qualsiasi, per i sei tag qui sopra Esatte Esatte

Quindi un template che usa {{cf.<key>}}, valori di riserva e condizioni viene elaborato allo stesso modo in una campagna e in un’automazione sui contatti. 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.

Definisci i campi che usi nei tag di unione.
Il linguaggio di template completo: variabili, valori di riserva e condizioni.

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.