Mit Hilfe von Liquid-Code ist es Ihnen möglich, variable Felder in E-Mail-Nachrichten einzubauen. So können Sie E-Mails mit den in doo vorliegenden Kontaktdaten individuell befüllen. In diesem Artikel wird Ihnen beschrieben, wie das geht und welche Anpassungsmöglichkeiten Sie haben.

1. Liquid-Code durch Personalisierungen einfügen
2. Liquid-Code selbst schreiben

1. Liquid-Code durch Personalisierungen einfügen

Um E-Mail Nachrichten individuell an Empfänger-Listen und Kontaktgruppen anzupassen, können Sie Personalisierungen verwenden. Klicken Sie dafür auf den von Ihnen in Ihre E-Mail-Nachricht eingefügten Textbaustein, in welchen Sie Platzhalter einfügen möchten. Dadurch taucht ein Fenster mit Bearbeitungsoptionen auf. Klicken Sie hier auf Personalisierungen und wählen Sie das passende Feld aus. Es sind organisations-, kontakt- und veranstaltungsbezogene Platzhalter vordefiniert.

 

Sie können, statt Personalisierungen einfach nur im Standard einzufügen, diese auch noch weiter anpassen.

Nehmen wir beispielsweise den Platzhalter für die Anrede: {{ contact.salutation }}. Der Platzhalter kann durch Filter weiter verändert werden. Fügen Sie dafür | und den gewünschten Filter innerhalb des Platzhalters ein.

Bsp: {{ contact.salutation | default: “Hallo” }}. Dieses Beispiel für den Einsatz von Filtern ist hilfreich, wenn das Geschlecht des Empfängers nicht bekannt ist und bei dem normalerweise “Sehr geehrte/r Frau/Herr” als Standardwert gegeben ist.

Einige für Sie hilfreiche Filter finden Sie in der nachfolgenden Tabelle. Ausführlichere Informationen können Sie hier in der Liquid Dokumentation einsehen.

{{ … | capitalize }}	Der Eingabewert wird groß geschrieben. titel -> Titel
{{ … | date: “%a, %b %d, %y” }}	Daten werden in einem anderem Format wiedergegeben. Hier beispielsweise Fri, Jul 17, 15
{{ … | default: 2.99 }}	Platzhalter werden mit einem Standardwert belegt, falls keine Daten vorhanden sind.
{{ … | downcase }}	Der Eingabewert wird klein geschrieben. Titel -> titel
{{ … | first }}	Gibt den ersten Wert eines *Arrays zurück
{{ … | join: ” and ” }}	Verbindet Werte eines *Arrays mit Beispielsweise hier and
{{ … | last }}	Gibt den letzten Wert eines *Arrays zurück
{{ … | prepend: “Liste: ” }}	Stellt einen **String (Hier Liste: ) dem aus den Daten gewonnen **String vor.
{{ … | replace: “dein”, “Ihr” }}	Ersetzt das erste Wort (Hier dein) durch das Zweite Wort (Hier Ihr) in einem **String

*Array = Aneinanderreihung von Elementen eines Datentyps. Die Elemente können durch ihre Stelle in der Reihe (startend mit 0) geordnet werden.

**String = Eine Zeichenkette, die beispielsweise Wörter oder Sätze ergibt und durch ” ” begrenzt ist.

2. Liquid-Code selber schreiben

Mit Liquid-Code ist es möglich logische Operationen und einen Kontrollfluss definieren. Durch den Einsatz von selbst verfasstem Liquid Code in E-Mail Nachrichten können Sie Standard E-Mails verfassen, die sich in Ihrem Inhalt an Art, Zeitpunkt, Veranstaltungsstatus, Größe, etc. anpasst. Außerdem können die E-Mail auch an unterschiedliche Empfängergruppen anpassen, sodass innerhalb einer Kampagne individuelle Informationen versendet werden können.

Um Liquid Code richtig zu verwenden und sicherzugehen, dass keine falschen Inhalte in E-Mail-Nachrichten auftauchen, sollten Sie nur dann selbst Code schreiben, wenn Sie auch Erfahrung mit anderen Programmiersprachen und Konzepten haben. In den nachfolgenden Ansätzen finden Sie Beispiele wie einige Programmierkonzepte in Liquid umgesetzt werden. Eine vollständige Dokumentation zu Liquid-Codes und Verwendungsmöglichkeiten finden Sie hier.

Variablen Definieren:

{% assign veranstalter = "doo" %}

IF-Operationen:

{% if veranstaltung.price <= 20 %}
  Das ist eine günstige Veranstaltung 
{% endif %}

{% if veranstaltung.name contains "Extra" %}
  Dies ist eine zusätzliche Veranstaltung.
{% endif %}

{% if teilnehmer.name and teilnehmer.name.size > 10 %}
  Wow, {{ teilnehmer }}, Sie haben einen langen Namen!
{% else %}
  Hallöchen!
{% endif %}

Split-Operator:

Teilt einen String in ein *Array an dem definierten Char.

{% assign teilnehmer = "John, Tim, Tina, Alex" | split: ", " %}

Array Indices ansprechen:

 {{ veranstaltung.teilnehmer[0] }}
 {{ veranstaltung.teilnehmer[1] }}
 {{ veranstaltung.teilnehmer[3] }}