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 a odkaz pro odhlášení a zjistěte, čím se liší od jazyka Temple.

Aktualizováno 1. 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í 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í.

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

Definujte pole, která používáte ve slučovacích značkách.
Proměnné, náhradní hodnoty a podmínky pro odesílání přes API.

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

Děkujeme za zpětnou vazbu.

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