Riferimento
Tag di unione
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.
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.
<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 prefissocf.. 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 sottocontactecustom_fieldsdistinguono 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{{.
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:
{{#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.