Che cosa sono i Liquid Tag (e come si possono usare su TicketingHub?)

Ha mai desiderato personalizzare ogni email o biglietto ricevuto dai clienti, senza dover riscrivere tutto ogni volta? È proprio qui che i Liquid Tag danno il meglio. Questa guida è pensata per gli utenti di TicketingHub che vogliono inviare messaggi intelligenti e dinamici, in grado di recuperare informazioni in tempo reale da ogni prenotazione.

Che si tratti di rivolgersi agli ospiti per nome, modificare il messaggio in base alla lingua o adattare i dettagli a seconda del giorno della settimana, i Liquid Tag consentono di automatizzare il processo mantenendo al tempo stesso un tocco personale. Non sono necessarie conoscenze di programmazione.

Che cos’è esattamente un Liquid Tag?

I Liquid Tag sono segnaposto, ovvero piccoli frammenti di codice che inseriscono automaticamente nei messaggi email, nei biglietti o nei messaggi automatici informazioni personalizzate provenienti dalla prenotazione del cliente.

Ad esempio, se scrive:

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

Il cliente riceverà:

Hello Carl, your tour is confirmed!

Importante: tutti i Liquid Tag in TicketingHub utilizzano le doppie parentesi graffe {{ }} per le variabili di output e {% %} per la logica. Utilizzi sempre questo formato: non usi le parentesi graffe singole { }.

Nota sugli strumenti di IA: se chiede a ChatGPT, Gemini o a un altro assistente IA di scrivere modelli con Liquid Tag, la sintassi suggerita potrebbe non corrispondere all’implementazione di TicketingHub. Quando viene mostrato, controlli il popover del badge Liquid Supported e utilizzi come riferimento gli esempi riportati in questa pagina.

Tipi di Liquid Tag disponibili

TicketingHub supporta due tipi principali di Liquid Tag:

Tag di output

Visualizzano dettagli specifici della prenotazione, come nomi, date e informazioni sul prodotto.

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

Tag di logica

Consentono di creare regole e visualizzare contenuti diversi in base a determinate condizioni, come la lingua della prenotazione, il tipo di biglietto o il giorno della settimana.

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

Come verificare se un’area supporta i Liquid Tag

Non è disponibile alcun interruttore di attivazione. Liquid funziona in un editor o in un campo in cui viene mostrato il badge Liquid Supported. È inoltre supportato nei messaggi di prenotazione di biglietti e voucher e nei piè di pagina dei biglietti.

Passi il mouse sul badge Liquid Supported per aprire il relativo popover. Lo utilizzi come riferimento aggiornato per quell’area, ma non presuma che il popover elenchi tutti i campi possibili. Visualizzi un’anteprima o testi il messaggio prima di inviarlo ai clienti.

Dove utilizzare i Liquid Tag in TicketingHub

I Liquid Tag funzionano in:

• editor e campi contrassegnati dal badge Liquid Supported
• messaggi supportati per la prenotazione di biglietti e voucher
• piè di pagina dei biglietti
• modelli email supportati per prodotti e account

Non tutte le variabili sono disponibili in ogni posizione. Le email relative a una prenotazione possono utilizzare i dettagli di una singola prenotazione, mentre ricevute, fatture, rimborsi e richieste di pagamento riguardano l’ordine nel suo complesso e dispongono di un insieme diverso di dettagli. Se un tag è vuoto, controlli il popover del badge e le indicazioni contestuali riportate di seguito, quindi esegua un test con un esempio reale.

Aggiungere Liquid a un’email del prodotto

1. Apra il prodotto e vada a Emails.
2. Individui il modello da modificare e selezioni View, quindi Edit.
3. Aggiunga al messaggio l’output o la logica Liquid supportati.
4. Salvi il modello.
5. Quando disponibile, utilizzi Send Test Email e controlli il risultato visualizzato prima di utilizzare il modello per i clienti.

Personalizzare in base alla lingua

Se ha clienti internazionali e locali, può adattare i messaggi in base alla lingua selezionata al momento della prenotazione.

Aggiornamento: la variabile {{ order.language }} ora acquisisce correttamente la lingua scelta dal cliente nel widget di prenotazione. La logica condizionale per la lingua funzionerà in modo affidabile per tutte le nuove prenotazioni.

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

Personalizzare in base al tipo di biglietto

Vuole rivolgere messaggi speciali ai clienti VIP o agli studenti? Utilizzi i tag condizionali per personalizzare i contenuti in base al tipo di biglietto.

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

Modificare il punto d’incontro in base al giorno della settimana

Se il luogo d’incontro cambia in determinati giorni, può configurare una regola per visualizzare automaticamente le informazioni corrette.

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

Condizioni avanzate per la lingua

Molti operatori organizzano tour per un pubblico internazionale. Questi esempi mantengono l’output come segnaposto in inglese, così può sostituirlo con la traduzione verificata.

Messaggio da destra a sinistra:

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

Messaggio specifico per lingua:

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

Suggerimento: può combinare in un unico messaggio le condizioni relative al tipo di biglietto, alla lingua e al giorno. Quando viene mostrato, controlli il badge Liquid Supported e visualizzi sempre un’anteprima del risultato.

Verificare il supporto prima della pubblicazione

Non presuma che Liquid funzioni in ogni campo di testo. Se il badge Liquid Supported non è presente e il campo non corrisponde a un messaggio supportato per la prenotazione di biglietti o voucher o a un piè di pagina del biglietto, esegua un test prima di fare affidamento sui contenuti dinamici.

I tag non supportati potrebbero apparire vuoti o rimanere visualizzati così come sono stati digitati. Invii un’email di prova o crei un biglietto o un voucher di prova prima di pubblicare modifiche destinate ai clienti.

Perché utilizzare i Liquid Tag?

Perché aiutano a:

• personalizzare automaticamente i messaggi ai clienti con dati reali della prenotazione
• inviare email nella lingua dei clienti senza dover gestire modelli separati
• evitare modifiche manuali e ridurre gli errori umani
• mostrare informazioni accurate e dinamiche per ogni prenotazione, come punti d’incontro, orari di prelievo, dettagli della guida e altro ancora

Liquid Tag comuni

I tag utilizzati più frequentemente sono raggruppati per categoria. La disponibilità dipende dal punto in cui vengono utilizzati e questo riferimento potrebbe non includere tutti i campi possibili. Quando viene mostrato, utilizzi il popover del badge Liquid Supported e consulti la sezione Quali tag supporta ciascuna email qui sotto per il contesto relativo alle email.

Ordine e prenotazione

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

Prodotto

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

Stagione, variante e opzione

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

Cliente

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

Partecipante

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

Prelievo

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

Fornitore

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

Guida

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

Canale e rivenditore

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

Pagamento e rimborso

{{ amount }}
{{ payment_link }}

Merce

{{ merchandise.name }}

Altro

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

Quali tag supporta ciascuna email

Non tutti i tag funzionano in ogni email. Un tag non supportato da una determinata email potrebbe essere visualizzato come vuoto; per questo, testi i modelli prima di utilizzarli. Quando viene mostrato, il popover del badge Liquid Supported rappresenta il riferimento aggiornato per quel modello, anche se potrebbe non elencare tutti i campi possibili.

Importante: dettagli della prenotazione e dell’ordine: tag come {{ attendee.* }}, {{ product.* }}, {{ option.* }}, {{ pickup.* }} e {{ guide.* }} descrivono una singola prenotazione e funzionano solo nelle email relative alla prenotazione. Le email di ricevuta, fattura, rimborso e richiesta di pagamento riguardano l’intero ordine, che può contenere più prenotazioni, pertanto questi tag non sono disponibili. Per il saluto, utilizzi invece {{ customer.first_name }}.

Email relative alla prenotazione

Conferma prenotazione biglietto, Conferma prenotazione voucher, Promemoria prenotazione, Prenotazione modificata, Prenotazione annullata, Feedback sulla prenotazione, Recupero di una prenotazione abbandonata.

Supportati: ordine e prenotazione, voucher, prodotto, stagione/variante/opzione, cliente, partecipante, prelievo, fornitore, guida, canale e rivenditore, altro.

Email di ricevuta e fattura

Ricevuta (inviata quando l’ordine è stato pagato per intero) e fattura/fattura proforma (inviata quando è ancora dovuto un acconto o un saldo).

Supportati: cliente, fornitore, ordine.

In queste email l’oggetto del messaggio è l’ordine, quindi scriva i campi dell’ordine senza il prefisso order.: {{ reference }}, {{ language }}, {{ referral_code }}, {{ checkout_url }}.

Email di rimborso

Inviate quando viene emesso un rimborso.

Supportati: cliente, fornitore, ordine, {{ amount }}.

Email di richiesta di pagamento

Inviate quando chiede a un cliente di pagare un saldo ancora dovuto.

Supportati: ordine, {{ amount }}, {{ payment_link }}.

In queste email il cliente e il fornitore sono nidificati nell’ordine: utilizzi {{ order.customer.first_name }} e {{ order.supplier.name }}.

Email relative alle carte regalo

Inviate quando un cliente acquista una carta regalo.

Supportati: cliente, fornitore, {{ reference }}, {{ merchandise.name }}.

Errori comuni da evitare

1. Utilizzare parentesi graffe singole invece di doppie

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

2. Confondere product e tour nei nomi delle variabili

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

TicketingHub utilizza product: questo è l’errore di sintassi più comune che riscontriamo.

3. Fidarsi della sintassi dei tag generata dall’IA

ChatGPT e Gemini potrebbero suggerire formati di Liquid Tag che non corrispondono all’implementazione di TicketingHub. Quando viene mostrato, controlli il badge Liquid Supported e confronti il suggerimento con gli esempi riportati in questa pagina.

4. Utilizzare i Liquid Tag senza verificarne il supporto

Cerchi il badge Liquid Supported oppure utilizzi un messaggio supportato per la prenotazione di biglietti o voucher o un piè di pagina del biglietto. Visualizzi un’anteprima del risultato prima della pubblicazione.

5. Variabile non disponibile per quel tipo di email

Alcune variabili sono disponibili solo per specifici tipi di email. Se un tag non viene visualizzato correttamente, consulti la sezione Quali tag supporta ciascuna email qui sopra: la variabile potrebbe non essere supportata da quell’email.

Liquid Tag in modo semplice

I Liquid Tag possono sembrare tecnici, ma una volta acquisita familiarità con il loro utilizzo possono cambiare radicalmente il modo di lavorare. Sono ideali per gli operatori che desiderano automatizzare le comunicazioni senza rinunciare a un tocco personale.

Se non sa come strutturare un tag, siamo a sua disposizione: ci contatti!