Přejít na obsah
Dokumentace

Reference

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.

Aktualizováno 20. 10. 2026

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í.

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>

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 {{#if bez 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ředpony cf.. 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 pod contact a custom_fields rozliš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 &#123;&#123;.

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í:

HTML
{{#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.

Definujte pole, která používáte ve slučovacích značkách.
Celý šablonovací jazyk: proměnné, náhradní hodnoty a podmínky.

Byla tato stránka užitečná?

Děkujeme za zpětnou vazbu.

Děkujeme, čteme každou zprávu.