# 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í](/cs/docs/audiences/unsubscribes/). |
| `{{cf.<key>}}` | Hodnotou [vlastního pole](/cs/docs/contacts/custom-fields/) 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ě](/cs/docs/campaigns/test-and-schedule/).

## Slučovací značky a Temple

Kampaně používají vlastní slučovací značky. Šablony odesílané přes [e-mailové API](/cs/docs/email-api/) a e-maily odesílané [automatizacemi](/cs/docs/automations/) používají [Temple](/cs/docs/templates/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>}}`.

## Související

  - [Vlastní pole](/cs/docs/contacts/custom-fields/): Definujte pole, která používáte ve slučovacích značkách.
  - [Temple](/cs/docs/templates/temple/): Proměnné, náhradní hodnoty a podmínky pro odesílání přes API.

---
Zdroj: https://emailit.com/cs/docs/campaigns/merge-tags/