Vad är Liquid Tags (och hur kan du använda dem i TicketingHub?)

Har du någon gång velat anpassa varje e-postmeddelande eller biljett som dina kunder får – utan att behöva skriva om allt varje gång? Det är precis där Liquid Tags kommer till sin rätt. Den här guiden är till för TicketingHub-användare som vill skicka smarta, dynamiska meddelanden som hämtar aktuell information från varje bokning.

Oavsett om du vill välkomna gäster med namn, ändra meddelanden baserat på språk eller anpassa detaljer beroende på veckodag hjälper Liquid Tags dig att automatisera processen och samtidigt behålla en personlig ton. Du behöver inte kunna programmera.

Vad är egentligen en Liquid Tag?

Liquid Tags är platshållare – små kodbitar som automatiskt infogar personlig information från en kunds bokning i dina e-postmeddelanden, biljetter eller automatiserade meddelanden.

Om du till exempel skriver:

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

får kunden:

Hello Carl, your tour is confirmed!

Viktigt: Alla Liquid Tags i TicketingHub använder dubbla klammerparenteser {{ }} för utdatavariabler och {% %} för logik. Använd alltid detta format – använd inte enkla klammerparenteser { }.

Obs om AI-verktyg: Om du ber ChatGPT, Gemini eller en annan AI-assistent att skriva mallar med Liquid Tags kanske syntaxen som föreslås inte överensstämmer med TicketingHubs implementering. Kontrollera informationsrutan för märket Liquid Supported när den visas och använd exemplen på den här sidan som vägledning.

Typer av Liquid Tags som du kan använda

TicketingHub stöder två huvudtyper av Liquid Tags:

Output Tags

Dessa visar specifika bokningsuppgifter, till exempel namn, datum och produktinformation.

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

Logic Tags

Dessa gör det möjligt att skapa regler och visa olika innehåll beroende på villkor – till exempel bokningens språk, biljettyp eller veckodag.

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

Så kontrollerar du om ett område stöder Liquid Tags

Det finns ingen aktiveringsknapp. Liquid fungerar i en redigerare eller ett fält där märket Liquid Supported visas. Funktionen stöds även i bokningsmeddelanden för biljetter och vouchers samt i biljettens sidfötter.

Hovra över märket Liquid Supported för att öppna informationsrutan. Använd den som aktuell referens för området, men utgå inte från att informationsrutan listar alla möjliga fält. Förhandsgranska eller testa meddelandet innan du skickar det till kunder.

Var du kan använda Liquid Tags i TicketingHub

Liquid Tags fungerar i:

• Redigerare och fält som är märkta med Liquid Supported
• Bokningsmeddelanden för biljetter och vouchers som stöds
• Biljettens sidfötter
• Mallar för produkt- och konto-e-postmeddelanden som stöds

Alla variabler är inte tillgängliga överallt. Bokningsmeddelanden kan använda uppgifter för en enskild bokning, medan kvitton, fakturor, återbetalningar och betalningsförfrågningar gäller hela ordern och har en annan uppsättning uppgifter. Om en tagg är tom kan du kontrollera informationsrutan för märket och kontextvägledningen nedan och sedan testa med ett verkligt exempel.

Lägg till Liquid i ett produktmeddelande

1. Öppna produkten och gå till Emails.
2. Leta upp mallen du vill ändra och välj View och sedan Edit.
3. Lägg till Liquid-output eller Liquid-logik som stöds i meddelandet.
4. Spara mallen.
5. Använd Send Test Email när alternativet finns och kontrollera det renderade resultatet innan du använder mallen för kunder.

Anpassa efter språk

Om du har internationella och lokala kunder kan du anpassa meddelanden efter det språk som valdes vid bokningen.

Uppdatering: Variabeln {{ order.language }} registrerar nu korrekt det språk som kunden valde i bokningswidgeten. Din villkorsstyrda språklogik fungerar tillförlitligt för alla nya bokningar.

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

Anpassa efter biljettyp

Vill du ge VIP-gäster eller studenter särskilda meddelanden? Använd villkorsstyrda taggar för att anpassa innehållet efter biljettyp.

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

Ändra mötesplats baserat på veckodag

Om mötesplatsen ändras vissa dagar kan du skapa en regel som automatiskt visar rätt information.

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

Avancerade språkvillkor

Många arrangörer genomför turer för en internationell målgrupp. Exemplen nedan behåller utdata på engelska som platshållare, så att du kan ersätta den med en granskad översättning.

Höger-till-vänster-meddelande:

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

Språkspecifikt meddelande:

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

Proffstips: Du kan kombinera villkor för biljettyp, språk och veckodag i ett och samma meddelande. Kontrollera märket Liquid Supported när det visas och förhandsgranska alltid resultatet.

Kontrollera stödet innan publicering

Utgå inte från att Liquid fungerar i alla textfält. Om märket Liquid Supported saknas och fältet inte är ett biljett- eller voucherbokningsmeddelande eller en biljettsidfot som stöds bör du testa det innan du förlitar dig på dynamiskt innehåll.

Taggar som inte stöds kan visas som tomma eller förbli exakt som de skrevs. Skicka ett testmeddelande eller skapa en testbiljett eller testvoucher innan du publicerar ändringar som riktar sig till kunder.

Varför använda Liquid Tags?

De hjälper dig att:

• Automatiskt anpassa kundmeddelanden med verkliga bokningsuppgifter
• Skicka e-post på dina kunders egna språk utan att underhålla separata mallar
• Undvika manuella ändringar och minska risken för mänskliga fel
• Visa korrekt, dynamisk information för varje bokning – mötesplatser, upphämtningstider, uppgifter om guider med mera

Vanliga Liquid Tags

Följande vanligt använda taggar är grupperade efter kategori. Tillgängligheten beror på var du använder dem, och den här referensen kanske inte innehåller alla möjliga fält. Använd informationsrutan för märket Liquid Supported när den visas och se Which Tags Each Email Supports nedan för information om e-postkontext.

Order och bokning

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

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äsong, variant och alternativ

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

Kund

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

Deltagare

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

Upphämtning

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

Leverantö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 och återförsäljare

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

Betalning och återbetalning

{{ amount }}
{{ payment_link }}

Varor

{{ merchandise.name }}

Övrigt

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

Vilka taggar som stöds av respektive e-postmeddelande

Alla taggar fungerar inte i alla e-postmeddelanden. En tagg som inte stöds i ett visst e-postmeddelande kan återges som tom, så testa mallarna innan du använder dem. Informationsrutan för märket Liquid Supported är den aktuella referensen för mallen när den visas, även om den kanske inte listar alla möjliga fält.

Viktigt – bokningsuppgifter kontra orderuppgifter: Taggar som {{ attendee.* }}, {{ product.* }}, {{ option.* }}, {{ pickup.* }} och {{ guide.* }} beskriver en enskild bokning och fungerar endast i bokningsmeddelanden. Kvitton, fakturor, återbetalningar och betalningsförfrågningar gäller hela ordern, som kan innehålla flera bokningar. Dessa taggar är därför inte tillgängliga där – använd i stället {{ customer.first_name }} i hälsningsfrasen.

Bokningsmeddelanden

Bekräftelse av biljettbokning, bekräftelse av voucherbokning, bokningspåminnelse, ändrad bokning, avbokad bokning, bokningsfeedback och återvinning av övergiven bokning.

Stöds: Order och bokning, voucher, produkt, säsong/variant/alternativ, kund, deltagare, upphämtning, leverantör, guide, kanal och återförsäljare samt övrigt.

Kvitto- och fakturameddelanden

Kvitto (skickas när ordern är fullt betald) samt faktura eller proformafaktura (skickas när en deposition eller ett utestående saldo återstår).

Stöds: Kund, leverantör och order.

I dessa e-postmeddelanden är ordern meddelandets ämne. Skriv därför orderfält utan prefixet order.: {{ reference }}, {{ language }}, {{ referral_code }}, {{ checkout_url }}.

Återbetalningsmeddelanden

Skickas när en återbetalning har genomförts.

Stöds: Kund, leverantör, order och {{ amount }}.

Meddelanden om betalningsförfrågan

Skickas när du ber en kund att betala ett utestående saldo.

Stöds: Order, {{ amount }} och {{ payment_link }}.

I dessa e-postmeddelanden ligger kunden och leverantören under ordern – använd {{ order.customer.first_name }} och {{ order.supplier.name }}.

Presentkortsmeddelanden

Skickas när en kund köper ett presentkort.

Stöds: Kund, leverantör, {{ reference }} och {{ merchandise.name }}.

Vanliga misstag att undvika

1. Använda enkla klammerparenteser i stället för dubbla

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

2. Förväxla product och tour i variabelnamn

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

TicketingHub använder product – detta är det vanligaste syntaxfelet vi ser.

3. Lita på syntax för taggar som genererats av AI

ChatGPT och Gemini kan föreslå Liquid Tag-format som inte överensstämmer med TicketingHubs implementering. Kontrollera märket Liquid Supported när det visas och jämför förslaget med exemplen på den här sidan.

4. Använda Liquid Tags utan att kontrollera stödet

Leta efter märket Liquid Supported eller använd ett biljett- eller voucherbokningsmeddelande eller en biljettsidfot som stöds. Förhandsgranska resultatet innan du publicerar.

5. Variabeln är inte tillgänglig i den aktuella e-posttypen

Vissa variabler är endast tillgängliga i specifika e-posttyper. Om en tagg inte återges kan du kontrollera Which Tags Each Email Supports ovan – variabeln kanske inte stöds i det e-postmeddelandet.

Liquid Tags på ett enkelt sätt

Liquid Tags kan låta tekniska, men när du väl har fått grepp om dem kan de förändra arbetssättet helt. De passar perfekt för upptagna arrangörer som vill automatisera kommunikationen utan att förlora den personliga kontakten.

Och om du någon gång är osäker på hur en tagg ska struktureras finns vi här för att hjälpa dig – hör bara av dig!