Hvad er Liquid-tags (og hvordan kan du bruge dem i TicketingHub?)

Har du nogensinde ønsket at gøre hver e-mail eller billet, som dine kunder modtager, personlig – uden at skulle omskrive det hele hver gang? Det er netop her, Liquid-tags kommer til deres ret. Denne vejledning er til TicketingHub-brugere, der vil sende intelligente, dynamiske meddelelser, som henter aktuelle oplysninger fra hver booking.

Uanset om du vil byde gæster velkommen ved navn, ændre meddelelsen afhængigt af sproget eller tilpasse oplysninger baseret på ugedagen, hjælper Liquid-tags dig med at automatisere processen og samtidig bevare det personlige præg. Der kræves ingen programmeringskundskaber.

Hvad er et Liquid-tag egentlig?

Liquid-tags er pladsholdere – små kodestykker, der automatisk indsætter personlige oplysninger fra en kundes booking i dine e-mails, billetter eller automatiserede meddelelser.

Hvis du for eksempel skriver:

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

vil din kunde modtage:

Hello Carl, your tour is confirmed!

Vigtigt: Alle Liquid-tags i TicketingHub bruger dobbelte tuborgklammer {{ }} til outputvariabler og {% %} til logik. Brug altid dette format – brug ikke enkelte klammer { }.

Bemærkning om AI-værktøjer: Hvis du beder ChatGPT, Gemini eller en anden AI-assistent om at skrive skabeloner med Liquid-tags, stemmer den foreslåede syntaks muligvis ikke overens med TicketingHubs implementering. Kontrollér popoveren for mærket Liquid Supported, når den vises, og brug eksemplerne på denne side som vejledning.

Typer af Liquid-tags, du kan bruge

TicketingHub understøtter to hovedtyper af Liquid-tags:

Output-tags

Disse viser specifikke bookingoplysninger som navne, datoer og produktoplysninger.

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

Logik-tags

Disse giver dig mulighed for at oprette regler og vise forskelligt indhold afhængigt af betingelser – f.eks. bookingsprog, billettype eller ugedag.

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

Sådan kontrollerer du, om et område understøtter Liquid-tags

Der findes ingen aktiveringsknap. Liquid fungerer i en editor eller et felt, hvor mærket Liquid Supported vises. Det understøttes også i bookingmeddelelser for billetter og værdikuponer samt i billetfødder.

Hold markøren over mærket Liquid Supported for at åbne popoveren. Brug den som den aktuelle reference for området, men gå ikke ud fra, at popoveren viser alle mulige felter. Forhåndsvis eller test din meddelelse, før du sender den til kunder.

Hvor kan du bruge Liquid-tags i TicketingHub?

Liquid-tags fungerer i:

• Editorer og felter, der er markeret med mærket Liquid Supported
• Understøttede bookingmeddelelser for billetter og værdikuponer
• Billetfødder
• Understøttede e-mailskabeloner for produkter og konti

Alle variabler er ikke tilgængelige alle steder. Booking-e-mails kan bruge oplysninger om én booking, mens kvitteringer, fakturaer, tilbagebetalinger og betalingsanmodninger omhandler hele ordren og derfor har et andet sæt oplysninger. Hvis et tag er tomt, skal du kontrollere popoveren for mærket og kontekstvejledningen nedenfor og derefter teste med et rigtigt eksempel.

Tilføj Liquid til en produkte-mail

1. Åbn produktet, og gå til E-mails.
2. Find den skabelon, du vil ændre, og vælg Vis og derefter Rediger.
3. Tilføj understøttet Liquid-output eller -logik til meddelelsen.
4. Gem skabelonen.
5. Brug Send test-e-mail, når det er muligt, og kontrollér det viste resultat, før du bruger skabelonen til kunder.

Tilpas efter sprog

Hvis du har internationale og lokale kunder, kan du tilpasse dine meddelelser efter det sprog, der blev valgt ved bookingen.

Opdatering: Variablen {{ order.language }} registrerer nu korrekt det sprog, som kunden valgte i bookingwidgetten. Din betingede sprogl ogik fungerer pålideligt for alle nye bookinger.

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

Gør indholdet personligt efter billettype

Vil du give VIP’er eller studerende særlige meddelelser? Brug betingede tags til at tilpasse indholdet efter billettype.

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

Skift mødested baseret på ugedagen

Hvis dit mødested ændrer sig på bestemte dage, kan du oprette en regel, der automatisk viser de korrekte oplysninger.

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

Avancerede sprogbetingelser

Mange operatører arrangerer ture for et internationalt publikum. Disse eksempler bevarer outputtet som en engelsk pladsholder, så du kan erstatte den med din gennemgåede oversættelse.

Højre-til-venstre-meddelelse:

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

Sprogafhængig meddelelse:

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

Eksperttip: Du kan kombinere betingelser for billettype, sprog og dag i den samme meddelelse. Kontrollér mærket Liquid Supported, når det vises, og forhåndsvis altid resultatet.

Kontrollér understøttelse, før du publicerer

Gå ikke ud fra, at Liquid fungerer i alle tekstfelter. Hvis mærket Liquid Supported ikke vises, og feltet ikke er en understøttet bookingmeddelelse for billet eller værdikupon eller en billetfod, skal du teste det, før du stoler på dynamisk indhold.

Ikke-understøttede tags kan blive vist som tomme eller forblive som indtastet. Send en test-e-mail, eller opret en testbillet eller -værdikupon, før du publicerer ændringer, der er synlige for kunder.

Hvorfor bruge Liquid-tags?

Fordi de hjælper dig med at:

• Gøre kundemeddelelser personlige automatisk med rigtige bookingdata
• Sende e-mails på dine kunders eget sprog uden at vedligeholde separate skabeloner
• Undgå manuelle ændringer og reducere menneskelige fejl
• Vise nøjagtige, dynamiske oplysninger for hver booking – mødesteder, afhentningstidspunkter, guideoplysninger og meget mere

Almindelige Liquid-tags

De følgende almindeligt anvendte tags er grupperet efter kategori. Tilgængeligheden afhænger af, hvor du bruger dem, og denne reference indeholder muligvis ikke alle mulige felter. Brug popoveren for mærket Liquid Supported, når den vises, og se Hvilke tags understøtter de enkelte e-mails nedenfor for oplysninger om e-mailkontekst.

Ordre og booking

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

Værdikupon

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

Sæson, variant og valgmulighed

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

Kunde

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

Deltager

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

Afhentning

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

Leverandør

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

Guide

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

Kanal og forhandler

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

Betaling og tilbagebetaling

{{ amount }}
{{ payment_link }}

Merchandise

{{ merchandise.name }}

Andet

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

Hvilke tags understøtter de enkelte e-mails?

Ikke alle tags fungerer i alle e-mails. Et tag, der ikke understøttes i en bestemt e-mail, kan blive vist som tomt, så test skabelonerne, før du bruger dem. Popoveren for mærket Liquid Supported er den aktuelle reference for skabelonen, når den vises, selv om den muligvis ikke viser alle mulige felter.

Vigtigt – bookingoplysninger kontra ordreoplysninger: Tags som {{ attendee.* }}, {{ product.* }}, {{ option.* }}, {{ pickup.* }} og {{ guide.* }} beskriver én booking og fungerer kun i booking-e-mails. E-mails om kvitteringer, fakturaer, tilbagebetalinger og betalingsanmodninger omhandler hele ordren, som kan indeholde flere bookinger, så disse tags er ikke tilgængelige dér – brug i stedet {{ customer.first_name }} i hilsenen.

Booking-e-mails

Bekræftelse af billetbooking, bekræftelse af værdikuponbooking, bookingpåmindelse, booking ændret, booking annulleret, feedback om booking, gendannelse af forladt booking.

Understøttet: Ordre og booking, værdikupon, produkt, sæson/variant/valgmulighed, kunde, deltager, afhentning, leverandør, guide, kanal og forhandler, andet.

E-mails om kvittering og faktura

Kvittering (sendes, når ordren er betalt fuldt ud) og faktura/proformafaktura (sendes, når en forudbetaling eller restsaldo mangler at blive betalt).

Understøttet: Kunde, leverandør, ordre.

I disse e-mails er ordren meddelelsens emne, så ordre felter skal skrives uden præfikset order.: {{ reference }}, {{ language }}, {{ referral_code }}, {{ checkout_url }}.

E-mails om tilbagebetaling

Sendes, når en tilbagebetaling er gennemført.

Understøttet: Kunde, leverandør, ordre, {{ amount }}.

E-mails med betalingsanmodning

Sendes, når du beder en kunde om at betale en udestående saldo.

Understøttet: Ordre, {{ amount }}, {{ payment_link }}.

I disse e-mails er kunden og leverandøren indlejret under ordren – brug {{ order.customer.first_name }} og {{ order.supplier.name }}.

E-mails om gavekort

Sendes, når en kunde køber et gavekort.

Understøttet: Kunde, leverandør, {{ reference }}, {{ merchandise.name }}.

Almindelige fejl, du bør undgå

1. Brug af enkelte klammer i stedet for dobbelte klammer

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

2. Forveksling af product og tour i variabelnavne

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

TicketingHub bruger product – det er den mest almindelige syntaksfejl, vi ser.

3. Blind tillid til AI-genereret tagsyntaks

ChatGPT og Gemini kan foreslå Liquid-tag-formater, der ikke stemmer overens med TicketingHubs implementering. Kontrollér mærket Liquid Supported, når det vises, og sammenlign forslaget med eksemplerne på denne side.

4. Brug af Liquid-tags uden at kontrollere understøttelsen

Se efter mærket Liquid Supported, eller brug en understøttet bookingmeddelelse for billet eller værdikupon eller en billetfod. Forhåndsvis resultatet, før du publicerer.

5. Variablen er ikke tilgængelig i denne e-mailtype

Nogle variabler er kun tilgængelige i bestemte e-mailtyper. Hvis et tag ikke bliver vist, skal du se Hvilke tags understøtter de enkelte e-mails ovenfor – variablen understøttes muligvis ikke i den pågældende e-mail.

Liquid-tags gjort enkelt

Liquid-tags lyder måske tekniske, men når du først har fået styr på dem, kan de gøre en enorm forskel. De er perfekte til travle operatører, der vil automatisere kommunikationen uden at miste det personlige præg.

Og hvis du nogensinde er i tvivl om, hvordan et tag skal struktureres, er vi her for at hjælpe – du skal bare kontakte os!