Reference
Slučovací značky
Personalizujte předměty a obsah kampaní slučovacími značkami pro jména, e-mail, vlastní pole, odkaz pro odhlášení a odkaz na správu odběrů, s náhradními hodnotami a podmínkami jazyka Temple.
Slučovací značky vkládají do kampaně vlastní údaje každého příjemce: jeho jméno do předmětu, vlastní pole do těla a jeho osobní odkazy pro odhlášení a správu odběrů. Kampaně je vykreslují pomocí Temple, šablonovacího jazyka Emailitu, takže můžete přidat i náhradní hodnoty a podmíněné bloky. Tato stránka uvádí všechny značky, pravidla syntaxe a jak si výsledek zobrazit v náhledu.
Dostupné značky
| Značka | Nahradí se |
|---|---|
{{first_name}} |
Křestním jménem kontaktu. |
{{last_name}} |
Příjmením kontaktu. |
{{email}} |
E-mailovou adresou kontaktu. |
{{unsubscribe_url}} |
Osobním odkazem příjemce pro odhlášení. Viz Odhlášení. |
{{manage_subscriptions_url}} |
Odkazem příjemce na stránku pro správu odběrů, kde si vybírá své seznamy kontaktů. V testovacích odesláních je prázdná. |
{{cf.<key>}} |
Hodnotou vlastního pole podle jeho klíče. Například {{cf.company}} pro pole s klíčem company. |
{{global.<key>}} |
Globální hodnotou workspace, například {{global.offer_url}}. Pro všechny příjemce je stejná. |
{{tags}} |
Štítky kontaktu, například vip, customer. {{#if tags}}…{{/if}} ověří, zda kontakt nějaký štítek má. |
{{score}} |
Skóre kontaktu. |
{{webview_url}} |
Odkazem na webovou verzi e-mailu, vykreslenou pro daného příjemce. |
S E-commerce, alfaverzí pro tým Emailitu, mají kampaně také značky pro produkty, slevové kódy, košík a nákupní údaje. Viz Produkty, kupony a košík.
Vlastní pole fungují i jako {{custom_fields.<key>}}, v zápisu, který používají automatizace, a každá značka je dostupná také pod contact, například {{contact.first_name}}.
Slučovací značky fungují v poli Subject kampaně, v obsahu HTML i ve verzi v prostém textu. V polích From name, From email a Reply to se nenahrazují.
<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>Vkládejte značky v editorech
- Rich-text editor: napište
@a zvolte proměnnou, nebo vlastní pole podle jeho názvu. - Dragit editor: použijte nabídku slučovacích polí, která obsahuje First name, Last name, Email a vaše vlastní pole. Odkazy pro odhlášení a správu odběrů jsou mezi speciálními odkazy.
- HTML editor a pole Subject: značku napište.
Pravidla syntaxe
- Mezery kolem názvu značky se ignorují, takže
{{ first_name }}funguje stejně jako{{first_name}}. Podmíněné bloky jsou přísnější:{{else}}a{{/if}}pište přesně tak, jak je uvedeno, a podmínku začněte zápisem{{#ifbez mezery za závorkami. - Na velikosti písmen v názvech značek nezáleží, takže funguje i
{{First_Name}}. Týká se to šesti značek z tabulky a předponycf.. Klíče vlastních polí se musí přesně shodovat s uloženým klíčem a klíče jsou vždy malými písmeny, takže pište{{cf.company}}, ne{{cf.Company}}. Cesty podcontactacustom_fieldsrozlišují velká a malá písmena. - Vlastní pole potřebují předponu. Pište
{{cf.company}}:{{company}}není slučovací značka, takže se vykreslí jako prázdný text. - Cokoli jiného ve dvojitých složených závorkách se odstraní. Temple považuje každé
{{…}}za proměnnou a proměnná bez hodnoty se vykreslí jako prázdný text. Escapovací syntaxe neexistuje: pokud chcete v HTML zobrazit doslovné dvojité závorky, zapište je jako{{.
Chybějící hodnoty
Když kontakt pro značku nemá hodnotu, značka se nahradí ničím. Za svislou čáru přidejte náhradní hodnotu, která se použije místo toho. Prázdné pole se počítá jako chybějící, takže i pro něj se použije náhradní hodnota.
| Obsah | Kontakt s křestním jménem | Kontakt bez křestního jména |
|---|---|---|
Hi {{first_name}}, |
Hi Ada, | Hi , |
Hi {{first_name|"there"}}, |
Hi Ada, | Hi there, |
Kolem náhradní hodnoty fungují dvojité uvozovky, jednoduché uvozovky i zápis bez uvozovek. Kontakty s chybějícím jménem najdete v seznamu kontaktů filtrem First name s podmínkou is empty.
Podmíněný obsah
Zobrazte blok jen kontaktům, které mají hodnotu, s volitelným {{else}} pro všechny ostatní:
{{#if cf.plan}}
<p>Your {{cf.plan}} plan now includes scheduled sending.</p>
{{else}}
<p>Upgrade to get scheduled sending.</p>
{{/if}}Podmínka je nepravdivá, když pole chybí, je prázdné, false nebo 0, jinak je pravdivá. Porovnání jako cf.plan == "Pro" neexistují: pokud chcete cílit na jednu hodnotu, uložte ji do samostatného pole, například do logického pole is_pro. Bloky lze vnořovat. Úplná pravidla najdete v části Podmínky.
Jak se hodnoty vykreslují
| Typ pole | Vykreslí se jako |
|---|---|
| Textové, číselné | Uložená hodnota, například Acme nebo 42. |
| Datové | YYYY-MM-DD, například 1990-04-12. |
| Logické | true, nebo false. |
| Výběrové | Vybraná možnost. |
| Vícevýběrové | Možnosti oddělené čárkami bez mezer, například news,offers. |
Hodnoty se vkládají přesně tak, jak jsou uložené, bez escapování HTML. Pokud lidé mohou zadávat vlastní jména, například přes veřejný přihlašovací formulář, zkontrolujte tyto hodnoty dřív, než je použijete v HTML.
Náhled slučovacích značek
- Preview as contact v kroku Preview and test vykreslí předmět a obsah s údaji skutečného kontaktu. Použijte ho ke kontrole jmen, vlastních polí a prázdných hodnot.
- Testovací odeslání na adresu, která patří kontaktu v tomto workspace, použije data tohoto kontaktu. U ostatních adres se
{{email}}nahradí testovací adresou a jména a vlastní pole zůstanou prázdná, takže se zobrazí náhradní hodnoty a bloky{{else}}. Odkaz pro odhlášení v testovacím e-mailu nikoho neodhlásí.
Viz Testování a naplánování kampaně.
Slučovací značky a Temple
Slučovací značky kampaní jsou proměnné jazyka Temple, které se vyplní z kontaktu příjemce. Šablony odesílané přes e-mailové API a e-maily odesílané automatizacemi používají Temple také, jen s jinými daty:
| Kampaně | Odeslání přes API | E-maily z automatizací | |
|---|---|---|---|
| Data | Kontakt příjemce | variables, které předáte |
Kontakt, data události a metadata spuštění |
| Vlastní pole | {{cf.<key>}} nebo {{custom_fields.<key>}} |
Cokoli předáte, např. objekt cf |
{{cf.<key>}} nebo {{custom_fields.<key>}} |
| Odkazy pro odhlášení a správu odběrů | {{unsubscribe_url}}, {{manage_subscriptions_url}} |
Neposkytují se | {{unsubscribe_url}}, {{manage_subscriptions_url}} v automatizacích v kontextu Contact |
| Velikost písmen v názvech značek | Libovolná, u šesti značek výše | Přesná | Přesná |
Šablona, která používá {{cf.<key>}}, náhradní hodnoty a podmínky, se tedy v kampani vykreslí stejně jako v automatizaci kontaktů. Pokud kampaň uložíte jako šablonu a odešlete ji přes API, Temple vyplní její značky z variables, které předáte. Předejte first_name pro {{first_name}}, objekt cf pro {{cf.company}} a vlastní unsubscribe_url, pokud obsah na odhlášení odkazuje.