Reference
Slučovací značky
Personalizujte předměty a obsah kampaní slučovacími značkami pro jména, e-mail, vlastní pole a odkaz pro odhlášení a zjistěte, čím se liší od 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í odkaz pro odhlášení. 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í. |
{{cf.<key>}} |
Hodnotou vlastního pole podle jeho klíče. Například {{cf.company}} pro pole s klíčem company. |
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. Odkaz pro odhlášení je mezi speciálními odkazy.
- HTML editor a pole Subject: značku napište.
Pravidla syntaxe
- Žádné mezery uvnitř složených závorek. Pište
{{first_name}}. Značka s mezerami, například{{ first_name }}, se nenahradí a v e-mailu se objeví tak, jak je napsaná. Nejvíc na tom záleží u odkazu pro odhlášení: kontrola v kroku Send přijme i{{ unsubscribe_url }}, ale funkčním odkazem se stane jen{{unsubscribe_url}}. - Na velikosti písmen v názvech značek nezáleží, takže funguje i
{{First_Name}}. 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}}. - Vlastní pole potřebují předponu
cf..{{company}}není slučovací značka a objeví se tak, jak je napsaná. - Cokoli jiného ve dvojitých složených závorkách zůstane, jak je napsáno. Emailit nahrazuje jen značky z tabulky výše.
Chybějící hodnoty
Když kontakt pro značku nemá hodnotu, značka se nahradí ničím. Kampaně nemají syntaxi pro náhradní hodnotu: {{first_name|"there"}} se nepodporuje a objeví se tak, jak je napsáno.
| Obsah | Kontakt s křestním jménem | Kontakt bez křestního jména |
|---|---|---|
Hi {{first_name}}, |
Hi Ada, | Hi , |
Hi there, |
Hi there, | Hi there, |
Buď tedy pište text, který se dobře čte i bez hodnoty, nebo zajistěte, aby ji měl každý. Kontakty s chybějícím jménem najdete v seznamu kontaktů filtrem First name s podmínkou is empty.
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í vyplní
{{email}}testovací adresou a jména a vlastní pole nechají prázdné. 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
Kampaně používají vlastní slučovací značky. Šablony odesílané přes e-mailové API a e-maily odesílané automatizacemi používají Temple, šablonovací jazyk Emailitu, který vypadá podobně, ale funguje jinak:
| Slučovací značky kampaní | Temple | |
|---|---|---|
| Kde se používají | Kampaně | Odeslání přes API a SMTP se šablonou, e-maily z automatizací |
| Data | Kontakt příjemce | variables, které předáte, nebo kontakt a data události ze spuštění automatizace |
| Pevná sada značek | Ano, pět značek výše | Ne, jakákoli proměnná, kterou předáte |
| Vnořené hodnoty | Jen cf.<key> |
Jakákoli cesta, například {{user.name}} |
| Náhradní hodnoty | Ne | Ano |
| Podmínky | Ne | Ano, {{#if ...}} |
| Odkaz pro odhlášení | {{unsubscribe_url}} |
Neposkytuje se |
V jazyce Temple se náhradní hodnota píše za svislou čáru, například {{first_name|"there"}}. 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. V automatizacích jsou vlastní pole kontaktu dostupná jako {{custom_fields.<key>}}, ne {{cf.<key>}}.