Riferimento
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. |
{{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.
<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>}}.