Wie verwende ich Bedingungen, um Inhalte anzuzeigen oder zu verbergen?

SecureMailMerge verwendet Liquid-Templating, sodass du Abschnitte deines Betreffs oder Texts in {% if %} … {% endif %}-Tags einfügen kannst, um sie basierend auf den Spaltenwerten eines Empfängers anzuzeigen oder zu verbergen. Kombiniere Bedingungen mit Vergleichsoperatoren, else/elsif-Zweigen und dem Schlüsselwort contains für volle Kontrolle.

SecureMailMerge personalisiert deine E-Mails mit Liquid Templating. Neben einfachen Tokens wie {{FirstName}} kannst du Bedingungen verwenden, um Inhaltsblöcke basierend auf den Daten jedes Empfängers anzuzeigen, zu verbergen oder zu ändern.

Bedingungen funktionieren sowohl in der Betreffzeile als auch im E-Mail-Text.

Grundlegendes if / endif

Wickle den Inhalt, den du optional machen möchtest, zwischen einen öffnenden {% if %}-Tag und einen schließenden {% endif %}-Tag ein. Die Bedingung wird für jeden Empfänger anhand des Werts in der benannten Spalte geprüft.

{% if Country == "Germany" %}
  Versand erfolgt aus unserem Lager in Berlin.
{% endif %}

Der Block wird nur für Empfänger eingefügt, deren Country-Spalte Germany entspricht. Alle anderen sehen an dieser Stelle nichts.

Textwerte müssen in Anführungszeichen gesetzt werden ("Germany" oder 'Germany'). Zahlen werden ohne Anführungszeichen geschrieben.

Hinzufügen eines else-Zweigs

Verwende {% else %}, um alternativen Inhalt bereitzustellen, wenn die Bedingung falsch ist.

{% if Plan == "Premium" %}
  Danke, dass du Premium-Kunde bist — deine Prioritäts-Support-Hotline ist +1 555 0100.
{% else %}
  Brauchst du Hilfe? Antworte auf diese E-Mail und wir helfen dir weiter.
{% endif %}

Mehrere Zweige mit elsif

Verknüpfe mehrere Bedingungen mit {% elsif %}. Der erste passende Zweig gewinnt.

{% if Tier == "Gold" %}
  Du hast unsere Gold-Vorteile freigeschaltet.
{% elsif Tier == "Silver" %}
  Du bist im Silber-Tarif.
{% else %}
  Willkommen an Bord!
{% endif %}

Vergleichsoperatoren

Du kannst Spaltenwerte mit einem dieser Operatoren vergleichen:

{% if OrderTotal >= 100 %}
  Du qualifizierst dich für kostenlosen Versand!
{% endif %}

Bedingungen mit and / or kombinieren

Verwende and und or, um mehr als eine Spalte gleichzeitig zu prüfen.

{% if Country == "USA" and Plan == "Premium" %}
  Deine US Premium-Vorteile sind aktiv.
{% endif %}

Überprüfen, ob eine Zelle einen Wert hat

In Liquid ist eine leere Zelle immer noch „truthy“, daher ist {% if Notes %} kein zuverlässiger Weg, um auf einen Wert zu prüfen. Verwende stattdessen blank — das passt auf leere Zellen und Zellen, die nur Leerzeichen enthalten:

{% if Notes != blank %}
  Eine Notiz von deinem Account Manager: {{Notes}}
{% endif %}

Um das Gegenteil zu machen — Inhalt nur anzeigen, wenn eine Zelle leer ist — kehre den Vergleich um:

{% if PhoneNumber == blank %}
  Wir haben keine Telefonnummer gespeichert. Antworte, um eine hinzuzufügen.
{% endif %}

Spaltennamen mit Leerzeichen

Wenn dein Spaltenkopf Leerzeichen (oder andere Sonderzeichen) enthält, beziehe dich mit der Klammernotation darauf – genauso wie bei einem normalen Token:

{% if ["Account Status"] == "Active" %}
  Dein Konto ist in gutem Zustand.
{% endif %}

Teil eines Werts mit contains abgleichen

contains prüft, ob ein Textwert eine Teilzeichenkette enthält.

{% if Email contains "@gmail.com" %}
  Tipp: Füge uns zu deinen Gmail-Kontakten hinzu, damit wir nicht im Promotions-Ordner landen.
{% endif %}

Eine Bedingung mit unless umkehren

{% unless %} ist das Gegenteil von {% if %} — der Block wird nur angezeigt, wenn die Bedingung falsch ist.

{% unless Country == "USA" %}
  Internationale Versandkosten gelten.
{% endunless %}

Einen von vielen Werten mit case / when auswählen

Wenn du zwischen mehreren festen Werten wechseln musst, ist {% case %} übersichtlicher als eine lange elsif-Kette.

{% case Language %}
  {% when "de" %}
    Vielen Dank für Ihre Bestellung!
  {% when "fr" %}
    Merci pour votre commande !
  {% else %}
    Thank you for your order!
{% endcase %}

Tipps

• Bedingungen können jeden Inhalt umschließen — Text, Links, Bilder oder sogar andere Tokens.
• Leerzeichen und Zeilenumbrüche innerhalb von {% if %}-Blöcken bleiben erhalten, also platziere deine Tags sorgfältig, um leere Zeilen in der finalen E-Mail zu vermeiden.
• Du kannst Bedingungen mit dem Standardwert Filter für Ersatztext und mit der Datumsformatierung für Daten kombinieren.
• Schließe immer jeden Tag: {% if %} braucht {% endif %}, {% unless %} braucht {% endunless %} und {% case %} braucht {% endcase %}. Ein fehlender Schlusstag verursacht einen Liquid-Syntaxfehler.