Wat zijn Liquid-tags (en hoe kunt u ze gebruiken in TicketingHub?)

Hebt u er ooit aan gedacht om elke e-mail of elk ticket dat uw klanten ontvangen te personaliseren, zonder het volledige bericht telkens opnieuw te moeten schrijven? Daar komen Liquid-tags goed van pas. Deze handleiding is bedoeld voor TicketingHub-gebruikers die slimme, dynamische berichten willen versturen waarin realtime-informatie uit elke boeking wordt opgehaald.

Of u gasten nu bij naam verwelkomt, berichten aanpast op basis van de taal of details wijzigt afhankelijk van de dag van de week: met Liquid-tags kunt u dit proces automatiseren en toch een persoonlijke benadering behouden. U hebt hiervoor geen programmeerkennis nodig.

Wat is een Liquid-tag precies?

Liquid-tags zijn tijdelijke aanduidingen: kleine stukjes code die automatisch gepersonaliseerde informatie uit de boeking van een klant invoegen in uw e-mails, tickets of geautomatiseerde berichten.

Als u bijvoorbeeld het volgende schrijft:

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

ontvangt uw klant het volgende:

Hello Carl, your tour is confirmed!

Belangrijk: Alle Liquid-tags in TicketingHub gebruiken dubbele accolades {{ }} voor uitvoervariabelen en {% %} voor logica. Gebruik altijd deze notatie en geen enkele accolades { }.

Opmerking over AI-tools: Als u ChatGPT, Gemini of een andere AI-assistent vraagt om sjablonen met Liquid-tags te schrijven, komt de voorgestelde syntaxis mogelijk niet overeen met de implementatie van TicketingHub. Controleer de pop-up van de badge Liquid Supported wanneer deze wordt weergegeven en gebruik de voorbeelden op deze pagina als leidraad.

Welke soorten Liquid-tags kunt u gebruiken?

TicketingHub ondersteunt twee hoofdtypen Liquid-tags:

Uitvoertags

Deze tonen specifieke boekingsgegevens, zoals namen, datums en productinformatie.

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

Logicatags

Hiermee kunt u regels opstellen en verschillende inhoud tonen afhankelijk van voorwaarden, zoals de boekingstaal, het tickettype of de dag van de week.

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

Controleren of een onderdeel Liquid-tags ondersteunt

Er is geen schakelaar om de functie te activeren. Liquid werkt in een editor of veld waarin de badge Liquid Supported wordt weergegeven. Liquid wordt ook ondersteund in boekingsberichten voor tickets en vouchers en in voetteksten van tickets.

Beweeg de muis over de badge Liquid Supported om de bijbehorende pop-up te openen. Gebruik deze als actuele referentie voor dat onderdeel, maar ga er niet van uit dat de pop-up elk mogelijk veld vermeldt. Bekijk een voorbeeld of test uw bericht voordat u het naar klanten verstuurt.

Waar kunt u Liquid-tags gebruiken in TicketingHub?

Liquid-tags werken in:

• Editors en velden met de badge Liquid Supported
• Ondersteunde boekingsberichten voor tickets en vouchers
• Voetteksten van tickets
• Ondersteunde e-mailsjablonen voor producten en accounts

Niet alle variabelen zijn op elke locatie beschikbaar. Boekingsmails kunnen gegevens van één boeking gebruiken, terwijl ontvangstbewijzen, facturen, terugbetalingen en betalingsverzoeken betrekking hebben op de volledige bestelling en een andere set gegevens gebruiken. Als een tag leeg blijft, controleert u de pop-up van de badge en de onderstaande contextinformatie en test u de tag vervolgens met een realistisch voorbeeld.

Liquid toevoegen aan een productmail

1. Open het product en ga naar E-mails.
2. Zoek het sjabloon dat u wilt wijzigen en selecteer Bekijken en vervolgens Bewerken.
3. Voeg ondersteunde Liquid-uitvoer of -logica toe aan het bericht.
4. Sla het sjabloon op.
5. Gebruik indien beschikbaar Testmail verzenden en controleer het weergegeven resultaat voordat u het sjabloon voor klanten gebruikt.

Personaliseren op basis van taal

Als u internationale en lokale klanten hebt, kunt u uw berichten afstemmen op basis van de taal die tijdens de boeking is geselecteerd.

Update: De variabele {{ order.language }} legt nu correct vast welke taal uw klant in de boekingswidget heeft gekozen. Uw voorwaardelijke taallogica werkt daardoor betrouwbaar voor alle nieuwe boekingen.

{% 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 %}

Personaliseren op basis van tickettype

Wilt u speciale berichten tonen aan VIP’s of studenten? Gebruik conditionele tags om de inhoud aan te passen op basis van het tickettype.

{% 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 %}

Het ontmoetingspunt wijzigen op basis van de dag van de week

Als uw ontmoetingslocatie op bepaalde dagen verandert, kunt u een regel instellen om automatisch de juiste informatie weer te geven.

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

Geavanceerde taalvoorwaarden

Veel organisatoren verzorgen rondleidingen voor een internationaal publiek. In deze voorbeelden blijft de uitvoer een Engelstalige tijdelijke aanduiding, zodat u deze kunt vervangen door uw gecontroleerde vertaling.

Van rechts naar links geschreven bericht:

{% 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 %}

Taalafhankelijk bericht:

{% 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 %}

Tip van de professional: U kunt voorwaarden voor tickettype, taal en dag combineren in één bericht. Controleer de badge Liquid Supported wanneer deze wordt weergegeven en bekijk altijd een voorbeeld van het resultaat.

Ondersteuning controleren voordat u publiceert

Ga er niet van uit dat Liquid in elk tekstveld werkt. Als er geen badge Liquid Supported wordt weergegeven en het veld geen ondersteund boekingsbericht voor tickets of vouchers of een ticketvoettekst is, test u het eerst voordat u op dynamische inhoud vertrouwt.

Niet-ondersteunde tags kunnen leeg worden weergegeven of als ingevoerde tekst blijven staan. Verstuur een testmail of maak een testticket of -voucher aan voordat u wijzigingen voor klanten publiceert.

Waarom Liquid-tags gebruiken?

Omdat ze u helpen om:

• Klantberichten automatisch te personaliseren met echte boekingsgegevens
• E-mails te versturen in de eigen taal van uw klanten zonder afzonderlijke sjablonen te onderhouden
• Handmatige bewerkingen te vermijden en menselijke fouten te beperken
• Voor elke boeking correcte, dynamische informatie te tonen, zoals ontmoetingspunten, ophaaltijden, gidsgegevens en meer

Veelgebruikte Liquid-tags

De volgende veelgebruikte tags zijn per categorie gegroepeerd. De beschikbaarheid is afhankelijk van de locatie waar u ze gebruikt en dit overzicht bevat mogelijk niet elk beschikbaar veld. Gebruik de pop-up van de badge Liquid Supported wanneer deze wordt weergegeven en bekijk hieronder Welke tags elk e-mailbericht ondersteunt voor de context van e-mails.

Bestelling en boeking

{{ 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 }}

Voucher

{{ 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.

Product

{{ 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 }}

Seizoen, variant en optie

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

Klant

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

Deelnemer

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

Ophalen

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

Aanbieder

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

Gids

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

Kanaal en wederverkoper

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

Betaling en terugbetaling

{{ amount }}
{{ payment_link }}

Merchandise

{{ merchandise.name }}

Overige

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

Welke tags elk e-mailbericht ondersteunt

Niet elke tag werkt in elk e-mailbericht. Een tag die in een bepaald e-mailbericht niet wordt ondersteund, kan leeg worden weergegeven. Test uw sjablonen daarom voordat u ze gebruikt. De pop-up van de badge Liquid Supported is de actuele referentie voor dat sjabloon wanneer deze wordt weergegeven, hoewel mogelijk niet elk beschikbaar veld wordt vermeld.

Belangrijk — boekingsgegevens versus bestelgegevens: Tags zoals {{ attendee.* }}, {{ product.* }}, {{ option.* }}, {{ pickup.* }} en {{ guide.* }} beschrijven één boeking en werken alleen in boekingsmails. E-mails voor ontvangstbewijzen, facturen, terugbetalingen en betalingsverzoeken hebben betrekking op de volledige bestelling, die meerdere boekingen kan bevatten. Deze tags zijn daar dus niet beschikbaar. Gebruik in plaats daarvan {{ customer.first_name }} voor de begroeting.

Boekingsmails

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

Ondersteund: bestelling en boeking, voucher, product, seizoen/variant/optie, klant, deelnemer, ophalen, aanbieder, gids, kanaal en wederverkoper, overige.

E-mails voor ontvangstbewijzen en facturen

Receipt (verzonden wanneer de bestelling volledig is betaald) en Invoice / Proforma Invoice (verzonden wanneer een aanbetaling of resterend bedrag openstaat).

Ondersteund: klant, aanbieder, bestelling.

In deze e-mails is de bestelling het onderwerp van het bericht. Gebruik bestelvelden daarom zonder het voorvoegsel order.: {{ reference }}, {{ language }}, {{ referral_code }}, {{ checkout_url }}.

E-mails voor terugbetalingen

Verzonden wanneer een terugbetaling wordt uitgevoerd.

Ondersteund: klant, aanbieder, bestelling, {{ amount }}.

E-mails voor betalingsverzoeken

Verzonden wanneer u een klant vraagt om een openstaand bedrag te betalen.

Ondersteund: bestelling, {{ amount }}, {{ payment_link }}.

In deze e-mails zijn de klant en de aanbieder genest onder de bestelling. Gebruik {{ order.customer.first_name }} en {{ order.supplier.name }}.

E-mails voor cadeaukaarten

Verzonden wanneer een klant een cadeaukaart koopt.

Ondersteund: klant, aanbieder, {{ reference }}, {{ merchandise.name }}.

Veelgemaakte fouten die u moet vermijden

1. Enkele accolades gebruiken in plaats van dubbele accolades

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

2. product en tour door elkaar halen in variabelenamen

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

TicketingHub gebruikt product. Dit is de meest voorkomende syntaxisfout die we zien.

3. Vertrouwen op door AI gegenereerde tagsyntaxis

ChatGPT en Gemini kunnen indelingen voor Liquid-tags voorstellen die niet overeenkomen met de implementatie van TicketingHub. Controleer de badge Liquid Supported wanneer deze wordt weergegeven en vergelijk het voorstel met de voorbeelden op deze pagina.

4. Liquid-tags gebruiken zonder de ondersteuning te controleren

Zoek naar de badge Liquid Supported of gebruik een ondersteund boekingsbericht voor tickets of vouchers of een ticketvoettekst. Bekijk het resultaat voordat u het publiceert.

5. Variabele niet beschikbaar in dat e-mailtype

Sommige variabelen zijn alleen beschikbaar in specifieke e-mailtypen. Als een tag niet wordt weergegeven, bekijkt u hierboven Welke tags elk e-mailbericht ondersteunt. De variabele wordt mogelijk niet ondersteund in dat e-mailbericht.

Liquid-tags eenvoudig gemaakt

Liquid-tags klinken misschien technisch, maar zodra u begrijpt hoe ze werken, kunnen ze een groot verschil maken. Ze zijn ideaal voor drukbezette organisatoren die communicatie willen automatiseren zonder het persoonlijke contact te verliezen.

En als u ooit twijfelt over de juiste structuur van een tag, staan we voor u klaar. Neem gewoon contact met ons op!