Was sind Liquid-Tags (und wie können Sie sie in TicketingHub verwenden?)

Wollten Sie schon immer jede E-Mail oder jedes Ticket, das Ihre Kundinnen und Kunden erhalten, personalisieren, ohne jedes Mal den gesamten Inhalt neu zu schreiben? Genau hier kommen Liquid-Tags ins Spiel. Dieser Leitfaden richtet sich an TicketingHub-Nutzerinnen und -Nutzer, die intelligente, dynamische Nachrichten versenden möchten, in denen automatisch Echtzeitinformationen aus jeder Buchung eingefügt werden.

Ganz gleich, ob Sie Gäste mit ihrem Namen begrüßen, Nachrichten abhängig von der Sprache ändern oder Details je nach Wochentag anpassen möchten: Liquid-Tags helfen Ihnen, diesen Prozess zu automatisieren und dennoch persönlich zu bleiben. Programmierkenntnisse sind nicht erforderlich.

Was genau ist ein Liquid-Tag?

Liquid-Tags sind Platzhalter – kleine Codeelemente, die automatisch personalisierte Informationen aus der Buchung einer Kundin oder eines Kunden in Ihre E-Mails, Tickets oder automatisierten Nachrichten einfügen.

Wenn Sie beispielsweise Folgendes schreiben:

Hello {{ customer.first_name }}, your tour is confirmed!

erhält Ihre Kundin oder Ihr Kunde:

Hello Carl, your tour is confirmed!

Wichtig: Alle Liquid-Tags in TicketingHub verwenden doppelte geschweifte Klammern {{ }} für Ausgabevariablen und {% %} für Logik. Verwenden Sie immer dieses Format – keine einfachen geschweiften Klammern { }.

Hinweis zu KI-Tools: Wenn Sie ChatGPT, Gemini oder einen anderen KI-Assistenten bitten, Liquid-Tag-Vorlagen zu erstellen, stimmt die vorgeschlagene Syntax möglicherweise nicht mit der TicketingHub-Implementierung überein. Prüfen Sie den Hinweis Liquid Supported, wenn er angezeigt wird, und orientieren Sie sich an den Beispielen auf dieser Seite.

Arten von Liquid-Tags, die Sie verwenden können

TicketingHub unterstützt zwei Hauptarten von Liquid-Tags:

Ausgabe-Tags

Diese zeigen bestimmte Buchungsdetails wie Namen, Daten und Produktinformationen an.

Hello {{ customer.first_name }}, your tour on {{ booked_for_date }} is confirmed.

Logik-Tags

Mit diesen können Sie Regeln erstellen und je nach Bedingungen unterschiedliche Inhalte anzeigen – beispielsweise abhängig von der Buchungssprache, dem Tickettyp oder dem Wochentag.

{% if order.language == "fr" %}
  Add your French-language message here.
{% else %}
  Hello! Thank you for your booking.
{% endif %}

So prüfen Sie, ob ein Bereich Liquid-Tags unterstützt

Es gibt keinen Aktivierungsschalter. Liquid funktioniert in einem Editor oder Feld, in dem der Hinweis Liquid Supported angezeigt wird. Liquid wird außerdem in Buchungsnachrichten für Tickets und Gutscheine sowie in Ticket-Fußzeilen unterstützt.

Bewegen Sie den Mauszeiger über den Hinweis Liquid Supported, um das zugehörige Popover zu öffnen. Verwenden Sie es als aktuelle Referenz für diesen Bereich, gehen Sie jedoch nicht davon aus, dass darin jedes mögliche Feld aufgeführt ist. Sehen Sie sich Ihre Nachricht in der Vorschau an oder testen Sie sie, bevor Sie sie an Kundinnen und Kunden senden.

Wo Sie Liquid-Tags in TicketingHub verwenden können

Liquid-Tags funktionieren in:

• Editoren und Feldern mit dem Hinweis Liquid Supported
• Unterstützten Buchungsnachrichten für Tickets und Gutscheine
• Ticket-Fußzeilen
• Unterstützten E-Mail-Vorlagen für Produkte und Konten

Nicht alle Variablen sind an jedem Ort verfügbar. Buchungs-E-Mails können Details zu einer einzelnen Buchung verwenden, während Quittungen, Rechnungen, Rückerstattungen und Zahlungsaufforderungen die übergeordnete Bestellung abdecken und einen anderen Satz an Details verwenden. Wenn ein Tag leer bleibt, prüfen Sie das Popover des Hinweises und die Kontextinformationen weiter unten und testen Sie anschließend mit einem echten Beispiel.

Liquid zu einer Produkt-E-Mail hinzufügen

1. Öffnen Sie das Produkt und gehen Sie zu Emails.
2. Suchen Sie die Vorlage, die Sie ändern möchten, und wählen Sie zunächst View und anschließend Edit.
3. Fügen Sie der Nachricht unterstützte Liquid-Ausgabe- oder Logik-Tags hinzu.
4. Speichern Sie die Vorlage.
5. Verwenden Sie, sofern verfügbar, Send Test Email und prüfen Sie das gerenderte Ergebnis, bevor Sie die Vorlage für Kundinnen und Kunden einsetzen.

Nach Sprache personalisieren

Wenn Sie internationale und lokale Kundinnen und Kunden haben, können Sie Ihre Nachrichten an die bei der Buchung ausgewählte Sprache anpassen.

Aktualisierung: Die Variable {{ order.language }} erfasst jetzt korrekt die Sprache, die Ihre Kundin oder Ihr Kunde im Buchungs-Widget ausgewählt hat. Ihre bedingte Sprachlogik funktioniert nun zuverlässig für alle neuen Buchungen.

{% if order.language == "es" %}
  Add your Spanish-language message here.
{% elsif order.language == "fr" %}
  Add your French-language message here.
{% else %}
  Hello! Thank you for your booking.
{% endif %}

Nach Tickettyp personalisieren

Möchten Sie VIP-Gästen oder Studierenden besondere Nachrichten anzeigen? Verwenden Sie bedingte Tags, um Inhalte anhand des Tickettyps anzupassen.

{% if tier_names contains "VIP" %}
  Welcome VIP! Enjoy your complimentary welcome drink.
{% elsif tier_names contains "Student" %}
  Don't forget to bring your student ID.
{% else %}
  Thanks for booking! Please arrive on time and enjoy the tour.
{% endif %}

Treffpunkt abhängig vom Wochentag ändern

Wenn sich Ihr Treffpunkt an bestimmten Tagen ändert, können Sie eine Regel einrichten, die automatisch die richtigen Informationen anzeigt.

{% assign weekday = booked_for_date | date: '%a' %}
{% if weekday == 'Mon' %}
  Please meet at our annex building.
{% else %}
  Please meet at our main office.
{% endif %}

Erweiterte Sprachbedingungen

Viele Anbieter veranstalten Touren für ein internationales Publikum. Diese Beispiele lassen die Ausgabe als englischen Platzhalter stehen, damit Sie sie durch Ihre geprüfte Übersetzung ersetzen können.

Nachricht für rechts-nach-links geschriebene Sprachen:

{% if order.language == "he" %}
<p style="direction: rtl; text-align: right;">
  Add your reviewed right-to-left message for {{ customer.first_name }} here.<br>
  <strong>Product:</strong> {{ product.name }}
</p>
{% else %}
  Hello {{ customer.first_name }}! Thank you for your booking.
{% endif %}

Sprachspezifische Nachricht:

{% if order.language == "ja" %}
  Add your Japanese-language message for {{ customer.first_name }} here.
  Product: {{ product.name }}
{% else %}
  Hello {{ customer.first_name }}, thank you for your booking.
  Tour: {{ product.name }}
{% endif %}

Profi-Tipp: Sie können Bedingungen für Tickettyp, Sprache und Wochentag in einer einzigen Nachricht kombinieren. Prüfen Sie den Hinweis Liquid Supported, wenn er angezeigt wird, und sehen Sie sich das Ergebnis immer in der Vorschau an.

Unterstützung vor der Veröffentlichung prüfen

Gehen Sie nicht davon aus, dass Liquid in jedem Textfeld funktioniert. Wenn kein Hinweis Liquid Supported angezeigt wird und das Feld weder eine unterstützte Buchungsnachricht für Tickets oder Gutscheine noch eine Ticket-Fußzeile ist, testen Sie es, bevor Sie sich auf dynamische Inhalte verlassen.

Nicht unterstützte Tags können leer erscheinen oder so verbleiben, wie sie eingegeben wurden. Senden Sie eine Test-E-Mail oder erstellen Sie ein Testticket bzw. einen Testgutschein, bevor Sie Änderungen mit Kundenbezug veröffentlichen.

Warum Liquid-Tags verwenden?

Weil sie Ihnen helfen:

• Kundennachrichten automatisch mit echten Buchungsdaten zu personalisieren
• E-Mails in der Sprache Ihrer Kundinnen und Kunden zu versenden, ohne separate Vorlagen pflegen zu müssen
• Manuelle Änderungen zu vermeiden und menschliche Fehler zu reduzieren
• Für jede Buchung genaue, dynamische Informationen anzuzeigen – Treffpunkte, Abholzeiten, Angaben zum Guide und mehr

Häufig verwendete Liquid-Tags

Die folgenden häufig verwendeten Tags sind nach Kategorien gruppiert. Welche Tags verfügbar sind, hängt davon ab, wo Sie sie verwenden. Diese Referenz enthält möglicherweise nicht jedes verfügbare Feld. Verwenden Sie das Popover des Hinweises Liquid Supported, wenn es angezeigt wird, und lesen Sie weiter unten den Abschnitt Welche Tags von den einzelnen E-Mails unterstützt werden, um den E-Mail-Kontext zu berücksichtigen.

Bestellung und Buchung

{{ reference }}
{{ order.reference }}
{{ order.language }}         — Language selected by the customer in the booking widget.
{{ order.referral_code }}
{{ order.checkout_url }}
{{ booked_for_date }}
{{ size }}                   — Number of people in the booking.
{{ group_booking }}
{{ questions_with_answers }}
{{ extra_names }}

Gutschein

{{ voucher }}                — Note: returns true or false indicating whether this is a voucher
                               booking. It does not contain a voucher or reference code — use
                               {{ reference }} for the booking reference.

Produkt

{{ product.name }}
{{ product.address.name }}
{{ product.address.building }}
{{ product.address.street }}
{{ product.address.city }}
{{ product.address.region }}
{{ product.address.postal_code }}
{{ product.address.country }}
{{ product.address.google_maps_url }}
{{ product.formatted_address }}

Saison, Variante und Option

{{ season.name }}
{{ variant.name }}
{{ tier_names }}
{{ option.name }}
{{ option.time }}

Kundin oder Kunde

{{ customer.first_name }}
{{ customer.last_name }}
{{ customer.full_name }}
{{ customer.company }}
{{ customer.email }}

Teilnehmende Person

{{ attendee.first_name }}
{{ attendee.last_name }}
{{ attendee.full_name }}
{{ attendee.company }}
{{ attendee.email }}

Abholung

{{ pickup.location }}
{{ pickup.time }}
{{ pickup.note }}
{{ pickup.map }}

Anbieter

{{ supplier.name }}
{{ supplier.logo }}
{{ supplier.logo_url }}
{{ supplier.website }}
{{ supplier.telephone }}
{{ supplier.email }}

Guide

{{ guide.name }}
{{ guide.first_name }}
{{ guide.last_name }}
{{ guide.telephone }}

Vertriebskanal und Wiederverkäufer

{{ channel.name }}
{{ reseller.name }}

Zahlung und Rückerstattung

{{ amount }}
{{ payment_link }}

Merchandise

{{ merchandise.name }}

Sonstige

{{ notes }}
{{ manage_booking_url }}
{{ smartwaiver_url }}
{{ tickets_download_url }}     — Link for the customer to download their tickets.

Welche Tags von den einzelnen E-Mails unterstützt werden

Nicht jeder Tag funktioniert in jeder E-Mail. Ein Tag, der in einer bestimmten E-Mail nicht unterstützt wird, kann leer angezeigt werden. Testen Sie Vorlagen daher, bevor Sie sie verwenden. Das Popover des Hinweises Liquid Supported ist, sofern angezeigt, die aktuelle Referenz für diese Vorlage, enthält möglicherweise jedoch nicht jedes verfügbare Feld.

Wichtig – Buchungs- und Bestelldetails: Tags wie {{ attendee.* }}, {{ product.* }}, {{ option.* }}, {{ pickup.* }} und {{ guide.* }} beschreiben eine einzelne Buchung und funktionieren nur in Buchungs-E-Mails. Quittungs-, Rechnungs-, Rückerstattungs- und Zahlungsaufforderungs-E-Mails decken die gesamte Bestellung ab, die mehrere Buchungen enthalten kann. Diese Tags sind dort daher nicht verfügbar – verwenden Sie stattdessen {{ customer.first_name }} für die Anrede.

Buchungs-E-Mails

Ticket Booking Confirmation, Voucher Booking Confirmation, Booking Reminder, Booking Changed, Booking Cancelled, Booking Feedback, Abandoned Booking Recovery.

Unterstützt: Bestellung und Buchung, Gutschein, Produkt, Saison/Variante/Option, Kundin oder Kunde, teilnehmende Person, Abholung, Anbieter, Guide, Vertriebskanal und Wiederverkäufer, Sonstige.

Quittungs- und Rechnungs-E-Mails

Receipt (wird gesendet, wenn die Bestellung vollständig bezahlt ist) und Invoice / Proforma Invoice (wird gesendet, wenn eine Anzahlung oder ein Restbetrag offen ist).

Unterstützt: Kundin oder Kunde, Anbieter, Bestellung.

In diesen E-Mails ist die Bestellung das Thema der Nachricht. Verwenden Sie Bestellfelder daher ohne das Präfix order.: {{ reference }}, {{ language }}, {{ referral_code }}, {{ checkout_url }}.

Rückerstattungs-E-Mails

Werden gesendet, wenn eine Rückerstattung ausgeführt wurde.

Unterstützt: Kundin oder Kunde, Anbieter, Bestellung, {{ amount }}.

E-Mails zu Zahlungsaufforderungen

Werden gesendet, wenn Sie eine Kundin oder einen Kunden auffordern, einen offenen Restbetrag zu begleichen.

Unterstützt: Bestellung, {{ amount }}, {{ payment_link }}.

In diesen E-Mails sind Kundin oder Kunde und Anbieter unter der Bestellung verschachtelt. Verwenden Sie {{ order.customer.first_name }} und {{ order.supplier.name }}.

Geschenkkarten-E-Mails

Werden gesendet, wenn eine Kundin oder ein Kunde eine Geschenkkarte kauft.

Unterstützt: Kundin oder Kunde, Anbieter, {{ reference }}, {{ merchandise.name }}.

Häufige Fehler vermeiden

1. Einfache statt doppelter geschweifter Klammern verwenden

Wrong:   { customer.first_name }
Correct: {{ customer.first_name }}

2. product und tour in Variablennamen verwechseln

Wrong:   {{ tour.name }}
Correct: {{ product.name }}

TicketingHub verwendet product. Dies ist der häufigste Syntaxfehler, den wir beobachten.

3. Der von einer KI generierten Tag-Syntax vertrauen

ChatGPT und Gemini schlagen möglicherweise Liquid-Tag-Formate vor, die nicht mit der TicketingHub-Implementierung übereinstimmen. Prüfen Sie den Hinweis Liquid Supported, wenn er angezeigt wird, und vergleichen Sie den Vorschlag mit den Beispielen auf dieser Seite.

4. Liquid-Tags verwenden, ohne die Unterstützung zu prüfen

Achten Sie auf den Hinweis Liquid Supported oder verwenden Sie eine unterstützte Buchungsnachricht für Tickets oder Gutscheine bzw. eine Ticket-Fußzeile. Sehen Sie sich das Ergebnis in der Vorschau an, bevor Sie es veröffentlichen.

5. Variable ist in diesem E-Mail-Typ nicht verfügbar

Einige Variablen sind nur in bestimmten E-Mail-Typen verfügbar. Wenn ein Tag nicht gerendert wird, prüfen Sie oben den Abschnitt Welche Tags von den einzelnen E-Mails unterstützt werden. Die Variable wird möglicherweise in dieser E-Mail nicht unterstützt.

Liquid-Tags einfach gemacht

Liquid-Tags mögen technisch klingen, aber sobald Sie den Dreh heraus haben, können sie Ihre Arbeitsweise grundlegend verbessern. Sie eignen sich ideal für Anbieter mit hohem Arbeitsaufkommen, die ihre Kommunikation automatisieren möchten, ohne die persönliche Note zu verlieren.

Wenn Sie einmal unsicher sind, wie Sie einen Tag strukturieren sollen, helfen wir Ihnen gerne weiter – wenden Sie sich einfach an uns!