Referenz
Platzhalter
Personalisieren Sie Betreff und Inhalt von Kampagnen mit Platzhaltern für Namen, E-Mail-Adresse, eigene Felder, den Abmeldelink und den Link zur Abonnementverwaltung, mit Ersatzwerten und Bedingungen von Temple.
Platzhalter fügen die Daten jedes einzelnen Empfängers in eine Kampagne ein: seinen Namen im Betreff, ein eigenes Feld im Inhalt und seine persönlichen Links zum Abmelden und zur Abonnementverwaltung. Kampagnen rendern sie mit Temple, der Template-Sprache von Emailit, daher können Sie auch Ersatzwerte und Bedingungsblöcke hinzufügen. Diese Seite listet alle Platzhalter und die Syntaxregeln auf und zeigt, wie Sie eine Vorschau des Ergebnisses sehen.
Verfügbare Platzhalter
| Platzhalter | Ersetzt durch |
|---|---|
{{first_name}} |
Den Vornamen des Kontakts. |
{{last_name}} |
Den Nachnamen des Kontakts. |
{{email}} |
Die E-Mail-Adresse des Kontakts. |
{{unsubscribe_url}} |
Den persönlichen Abmeldelink des Empfängers. Siehe Abmeldungen. |
{{manage_subscriptions_url}} |
Den Link des Empfängers zur Seite zur Abonnementverwaltung, auf der er seine Kontaktlisten wählt. In Testversänden leer. |
{{cf.<key>}} |
Den Wert eines eigenen Felds, über seinen Schlüssel. Zum Beispiel {{cf.company}} für ein Feld mit dem Schlüssel company. |
{{global.<key>}} |
Einen globalen Wert des Workspaces, etwa {{global.offer_url}}. Für jeden Empfänger gleich. |
{{tags}} |
Die Tags des Kontakts, etwa vip, customer. {{#if tags}}…{{/if}} prüft, ob der Kontakt welche hat. |
{{score}} |
Den Lead-Score des Kontakts. |
{{webview_url}} |
Einen Link zur Webversion der E-Mail, gerendert für diesen Empfänger. |
Mit Commerce, einer Alpha für das Emailit-Team, haben Kampagnen außerdem Platzhalter für Produkte, Gutscheincodes, den Warenkorb und Kaufdaten. Siehe Produkte, Gutscheine und der Warenkorb.
Eigene Felder funktionieren auch als {{custom_fields.<key>}}, die Form, die Automatisierungen verwenden, und jeder Platzhalter ist auch unter contact verfügbar, zum Beispiel {{contact.first_name}}.
Platzhalter funktionieren im Subject der Kampagne, im HTML-Inhalt und in der Nur-Text-Version. In From name, From email und Reply to werden sie nicht ersetzt.
<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>Platzhalter in den Editoren einfügen
- Rich-text editor: Tippen Sie
@und wählen Sie eine Variable oder ein eigenes Feld über seinen Namen. - Dragit editor: Verwenden Sie das Menü für Merge-Felder, das First name, Last name, Email und Ihre eigenen Felder auflistet. Der Abmeldelink und der Link zur Abonnementverwaltung stehen bei den speziellen Links.
- HTML editor und das Feld Subject: Tippen Sie den Platzhalter ein.
Syntaxregeln
- Leerzeichen um den Namen eines Platzhalters werden ignoriert,
{{ first_name }}funktioniert also wie{{first_name}}. Bedingungsblöcke sind strenger: Schreiben Sie{{else}}und{{/if}}genau wie gezeigt, und beginnen Sie eine Bedingung mit{{#if, ohne Leerzeichen nach den Klammern. - Bei Platzhalternamen spielt Groß-/Kleinschreibung keine Rolle, daher funktioniert auch
{{First_Name}}. Das gilt für die sechs Platzhalter in der Tabelle und das Präfixcf.. Schlüssel eigener Felder müssen genau dem gespeicherten Schlüssel entsprechen, und Schlüssel sind immer kleingeschrieben. Schreiben Sie also{{cf.company}}, nicht{{cf.Company}}. Pfade untercontactundcustom_fieldsunterscheiden Groß- und Kleinschreibung. - Eigene Felder brauchen ein Präfix. Schreiben Sie
{{cf.company}}:{{company}}ist kein Platzhalter und wird daher leer gerendert. - Alles andere in doppelten Klammern wird entfernt. Temple behandelt jedes
{{…}}als Platzhalter, und einer ohne Wert wird leer gerendert. Es gibt keine Escape-Syntax: Um doppelte geschweifte Klammern in HTML wörtlich anzuzeigen, schreiben Sie sie als{{.
Fehlende Werte
Hat ein Kontakt für einen Platzhalter keinen Wert, wird der Platzhalter durch nichts ersetzt. Fügen Sie nach einem senkrechten Strich einen Ersatzwert hinzu, der stattdessen verwendet wird. Ein leeres Feld gilt als fehlend und erhält daher ebenfalls den Ersatzwert.
| Inhalt | Kontakt mit Vornamen | Kontakt ohne Vornamen |
|---|---|---|
Hi {{first_name}}, |
Hi Ada, | Hi , |
Hi {{first_name|"there"}}, |
Hi Ada, | Hi there, |
Um den Ersatzwert können Sie doppelte, einfache oder gar keine Anführungszeichen setzen. Filtern Sie in der Übersicht der Kontakte nach First name mit is empty, um Kontakte ohne Namen zu finden.
Bedingte Inhalte
Zeigen Sie einen Block nur Kontakten an, die einen Wert haben, mit einem optionalen {{else}} für alle anderen:
{{#if cf.plan}}
<p>Your {{cf.plan}} plan now includes scheduled sending.</p>
{{else}}
<p>Upgrade to get scheduled sending.</p>
{{/if}}Eine Bedingung ist falsch, wenn das Feld fehlt, leer, false oder 0 ist, und sonst wahr. Es gibt keine Vergleiche wie cf.plan == "Pro": Um nach einem bestimmten Wert zu unterscheiden, speichern Sie ihn in einem gesonderten Feld, zum Beispiel als Boolean is_pro. Blöcke lassen sich verschachteln. Die vollständigen Regeln finden Sie unter Bedingungen.
So werden Werte dargestellt
| Feldtyp | Dargestellt als |
|---|---|
| Text, Zahl | Der gespeicherte Wert, zum Beispiel Acme oder 42. |
| Datum | YYYY-MM-DD, zum Beispiel 1990-04-12. |
| Boolean | true oder false. |
| Auswahl | Die ausgewählte Option. |
| Mehrfachauswahl | Die Optionen durch Kommas getrennt, ohne Leerzeichen, zum Beispiel news,offers. |
Werte werden genau so eingefügt, wie sie gespeichert sind, ohne HTML-Escaping. Wenn Personen ihre Namen selbst eingeben können, etwa über ein öffentliches Anmeldeformular, prüfen Sie diese Werte, bevor Sie sie in HTML verwenden.
Vorschau der Platzhalter
- Preview as contact im Schritt Preview and test rendert Betreff und Inhalt mit den Daten eines echten Kontakts. Prüfen Sie damit Namen, eigene Felder und leere Werte.
- Testversände an eine Adresse, die zu einem Kontakt in diesem Workspace gehört, verwenden die Daten dieses Kontakts. Bei anderen Adressen wird
{{email}}mit der Testadresse gefüllt, und Namen und eigene Felder bleiben leer, sodass Ersatzwerte und{{else}}-Blöcke angezeigt werden. Der Abmeldelink in einem Test meldet niemanden ab.
Siehe Testen und planen.
Platzhalter und Temple
Die Platzhalter in Kampagnen sind Platzhalter von Temple, die aus dem Kontakt des Empfängers gefüllt werden. Vorlagen, die über die E-Mail-API gesendet werden, und E-Mails aus Automatisierungen verwenden ebenfalls Temple, mit anderen Daten:
| Kampagnen | Versand per API | E-Mails aus Automatisierungen | |
|---|---|---|---|
| Daten | Der empfangende Kontakt | Die übergebenen variables |
Kontakt, Event-Daten und Metadaten des Durchlaufs |
| Eigene Felder | {{cf.<key>}} oder {{custom_fields.<key>}} |
Was Sie übergeben, etwa ein Objekt cf |
{{cf.<key>}} oder {{custom_fields.<key>}} |
| Abmeldelink und Link zur Abonnementverwaltung | {{unsubscribe_url}}, {{manage_subscriptions_url}} |
Nicht vorhanden | {{unsubscribe_url}}, {{manage_subscriptions_url}} in Contact-Automatisierungen |
| Groß-/Kleinschreibung der Platzhalternamen | Beliebig, für die sechs Platzhalter oben | Exakt | Exakt |
Eine Vorlage, die {{cf.<key>}}, Ersatzwerte und Bedingungen verwendet, wird daher in einer Kampagne genauso gerendert wie in einer Automatisierung mit Kontakten. Wenn Sie eine Kampagne als Vorlage speichern und per API senden, füllt Temple die Platzhalter aus den übergebenen variables. Übergeben Sie first_name für {{first_name}}, ein Objekt cf für {{cf.company}} und Ihre eigene unsubscribe_url, wenn der Inhalt auf eine solche verlinkt.