Liquid Tags là gì (và bạn có thể sử dụng chúng trên TicketingHub như thế nào?)

Bạn đã bao giờ muốn cá nhân hóa mọi email hoặc vé mà khách hàng nhận được—mà không phải viết lại toàn bộ nội dung mỗi lần chưa? Đó chính là lúc Liquid Tags phát huy tác dụng. Hướng dẫn này dành cho người dùng TicketingHub muốn gửi các tin nhắn thông minh, linh hoạt và tự động lấy thông tin theo thời gian thực từ từng đặt chỗ.

Dù bạn muốn chào đón khách bằng tên, thay đổi nội dung dựa trên ngôn ngữ hay điều chỉnh thông tin tùy theo ngày trong tuần, Liquid Tags giúp bạn tự động hóa quy trình mà vẫn giữ được tính cá nhân. Bạn không cần biết lập trình.

Liquid Tag chính xác là gì?

Liquid Tags là các trình giữ chỗ — những đoạn mã nhỏ tự động chèn thông tin được cá nhân hóa từ đặt chỗ của khách hàng vào email, vé hoặc tin nhắn tự động.

Ví dụ, nếu bạn viết:

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

Khách hàng sẽ nhận được:

Hello Carl, your tour is confirmed!

Quan trọng: Tất cả Liquid tag trên TicketingHub đều sử dụng hai dấu ngoặc nhọn {{ }} cho biến đầu ra và {% %} cho logic. Luôn sử dụng đúng định dạng này — không sử dụng dấu ngoặc nhọn đơn { }.

Lưu ý về các công cụ AI: Nếu bạn yêu cầu ChatGPT, Gemini hoặc một trợ lý AI khác viết mẫu Liquid tag, cú pháp được đề xuất có thể không khớp với cách triển khai của TicketingHub. Khi hiển thị, hãy kiểm tra cửa sổ bật lên của nhãn Liquid Supported và sử dụng các ví dụ trên trang này làm hướng dẫn.

Các loại Liquid Tag bạn có thể sử dụng

TicketingHub hỗ trợ hai loại Liquid Tag chính:

Tag đầu ra

Các tag này hiển thị những thông tin cụ thể của đặt chỗ, chẳng hạn như tên, ngày và thông tin sản phẩm.

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

Tag logic

Các tag này cho phép bạn tạo quy tắc và hiển thị nội dung khác nhau tùy theo điều kiện — chẳng hạn như ngôn ngữ đặt chỗ, loại vé hoặc ngày trong tuần.

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

Cách kiểm tra một khu vực có hỗ trợ Liquid Tags hay không

Không có công tắc kích hoạt. Liquid hoạt động trong trình chỉnh sửa hoặc trường có hiển thị nhãn Liquid Supported. Liquid cũng được hỗ trợ trong tin nhắn đặt vé và đặt voucher, cũng như phần chân trang của vé.

Di chuột qua nhãn Liquid Supported để mở cửa sổ bật lên. Hãy sử dụng cửa sổ này làm tài liệu tham chiếu trực tiếp cho khu vực đó, nhưng đừng cho rằng cửa sổ bật lên liệt kê mọi trường có thể sử dụng. Hãy xem trước hoặc kiểm tra tin nhắn trước khi gửi cho khách hàng.

Nơi sử dụng Liquid Tags trên TicketingHub

Liquid Tags hoạt động trong:

• Các trình chỉnh sửa và trường có nhãn Liquid Supported
• Tin nhắn đặt vé và đặt voucher được hỗ trợ
• Phần chân trang của vé
• Các mẫu email sản phẩm và tài khoản được hỗ trợ

Không phải mọi biến đều có sẵn ở mọi vị trí. Email đặt chỗ có thể sử dụng thông tin của một đặt chỗ, trong khi biên lai, hóa đơn, khoản hoàn tiền và yêu cầu thanh toán bao quát toàn bộ đơn hàng và có một tập hợp thông tin khác. Nếu một tag bị trống, hãy kiểm tra cửa sổ bật lên của nhãn và hướng dẫn theo ngữ cảnh bên dưới, sau đó thử nghiệm bằng một ví dụ thực tế.

Thêm Liquid vào email sản phẩm

1. Mở sản phẩm và đi đến Emails.
2. Tìm mẫu bạn muốn thay đổi và chọn View, sau đó chọn Edit.
3. Thêm đầu ra hoặc logic Liquid được hỗ trợ vào tin nhắn.
4. Lưu mẫu.
5. Khi có thể, hãy sử dụng Send Test Email và kiểm tra kết quả hiển thị trước khi dùng mẫu cho khách hàng.

Tùy chỉnh theo ngôn ngữ

Nếu bạn phục vụ cả khách hàng quốc tế và khách hàng địa phương, bạn có thể điều chỉnh nội dung dựa trên ngôn ngữ được chọn khi đặt chỗ.

Cập nhật: Biến {{ order.language }} hiện đã ghi nhận chính xác ngôn ngữ khách hàng chọn trong widget đặt chỗ. Logic ngôn ngữ điều kiện của bạn sẽ hoạt động ổn định trên tất cả đặt chỗ mới.

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

Cá nhân hóa theo loại vé

Bạn muốn gửi thông điệp đặc biệt cho khách VIP hoặc sinh viên? Sử dụng các tag điều kiện để tùy chỉnh dựa trên loại vé.

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

Thay đổi điểm gặp dựa trên ngày trong tuần

Nếu địa điểm gặp thay đổi vào một số ngày nhất định, bạn có thể thiết lập quy tắc để tự động hiển thị thông tin chính xác.

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

Điều kiện ngôn ngữ nâng cao

Nhiều đơn vị vận hành tổ chức tour cho khách quốc tế. Các ví dụ này giữ phần đầu ra dưới dạng trình giữ chỗ bằng tiếng Anh để bạn thay thế bằng bản dịch đã được kiểm duyệt.

Tin nhắn từ phải sang trái:

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

Tin nhắn theo ngôn ngữ:

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

Mẹo chuyên môn: Bạn có thể kết hợp các điều kiện về loại vé, ngôn ngữ và ngày trong cùng một tin nhắn. Khi hiển thị, hãy kiểm tra nhãn Liquid Supported và luôn xem trước kết quả.

Kiểm tra khả năng hỗ trợ trước khi xuất bản

Đừng cho rằng Liquid hoạt động trong mọi trường văn bản. Nếu không có nhãn Liquid Supported và trường đó không phải là tin nhắn đặt vé hoặc đặt voucher được hỗ trợ hay phần chân trang của vé, hãy kiểm tra trước khi dựa vào nội dung động.

Các tag không được hỗ trợ có thể hiển thị trống hoặc vẫn xuất hiện đúng như nội dung đã nhập. Hãy gửi email thử nghiệm hoặc tạo vé hay voucher thử nghiệm trước khi xuất bản các thay đổi hướng đến khách hàng.

Tại sao nên sử dụng Liquid Tags?

Vì chúng giúp bạn:

• Tự động cá nhân hóa tin nhắn khách hàng bằng dữ liệu đặt chỗ thực tế
• Gửi email bằng ngôn ngữ của khách hàng mà không phải duy trì các mẫu riêng biệt
• Tránh chỉnh sửa thủ công và giảm sai sót do con người
• Hiển thị thông tin chính xác, linh hoạt cho từng đặt chỗ — điểm gặp, giờ đón, thông tin hướng dẫn viên và nhiều nội dung khác

Các Liquid Tag thường dùng

Các tag thường dùng sau đây được nhóm theo danh mục. Khả năng sử dụng phụ thuộc vào nơi bạn dùng chúng và danh sách tham chiếu này có thể không bao gồm mọi trường có thể sử dụng. Khi hiển thị, hãy sử dụng cửa sổ bật lên của nhãn Liquid Supported và xem phần Email nào hỗ trợ từng Tag bên dưới để biết ngữ cảnh email.

Đơn hàng & Đặt chỗ

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

Sản phẩm

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

Mùa, Biến thể & Tùy chọn

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

Khách hàng

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

Người tham dự

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

Đón khách

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

Nhà cung cấp

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

Hướng dẫn viên

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

Kênh & Đại lý bán lại

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

Thanh toán & Hoàn tiền

{{ amount }}
{{ payment_link }}

Hàng hóa

{{ merchandise.name }}

Khác

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

Email nào hỗ trợ từng Tag

Không phải tag nào cũng hoạt động trong mọi email. Tag không được hỗ trợ trong một email cụ thể có thể hiển thị trống, vì vậy hãy kiểm tra các mẫu trước khi sử dụng. Khi hiển thị, cửa sổ bật lên của nhãn Liquid Supported là tài liệu tham chiếu trực tiếp cho mẫu đó, dù có thể không liệt kê mọi trường có thể sử dụng.

Quan trọng — thông tin đặt chỗ và thông tin đơn hàng: Các tag như {{ attendee.* }}, {{ product.* }}, {{ option.* }}, {{ pickup.* }} và {{ guide.* }} mô tả một đặt chỗ duy nhất và chỉ hoạt động trong email đặt chỗ. Email Biên lai, Hóa đơn, Hoàn tiền và Yêu cầu thanh toán bao quát toàn bộ đơn hàng (có thể chứa nhiều đặt chỗ), vì vậy các tag đó không khả dụng ở đây — thay vào đó, hãy sử dụng {{ customer.first_name }} cho lời chào.

Email đặt chỗ

Xác nhận đặt vé, Xác nhận đặt voucher, Nhắc nhở đặt chỗ, Đặt chỗ đã thay đổi, Đặt chỗ đã hủy, Phản hồi về đặt chỗ, Khôi phục đặt chỗ bị bỏ dở.

Được hỗ trợ: Đơn hàng & Đặt chỗ, Voucher, Sản phẩm, Mùa/Biến thể/Tùy chọn, Khách hàng, Người tham dự, Đón khách, Nhà cung cấp, Hướng dẫn viên, Kênh & Đại lý bán lại, Khác.

Email biên lai & hóa đơn

Biên lai (gửi khi đơn hàng đã được thanh toán đầy đủ) và Hóa đơn / Hóa đơn chiếu lệ (gửi khi còn khoản đặt cọc hoặc số dư chưa thanh toán).

Được hỗ trợ: Khách hàng, Nhà cung cấp, Đơn hàng.

Trong các email này, đơn hàng là đối tượng của tin nhắn, vì vậy hãy viết các trường đơn hàng không có tiền tố order.: {{ reference }}, {{ language }}, {{ referral_code }}, {{ checkout_url }}.

Email hoàn tiền

Được gửi khi khoản hoàn tiền được thực hiện.

Được hỗ trợ: Khách hàng, Nhà cung cấp, Đơn hàng, {{ amount }}.

Email yêu cầu thanh toán

Được gửi khi bạn yêu cầu khách hàng thanh toán số dư còn lại.

Được hỗ trợ: Đơn hàng, {{ amount }}, {{ payment_link }}.

Trong các email này, khách hàng và nhà cung cấp nằm bên trong đơn hàng — hãy sử dụng {{ order.customer.first_name }} và {{ order.supplier.name }}.

Email thẻ quà tặng

Được gửi khi khách hàng mua thẻ quà tặng.

Được hỗ trợ: Khách hàng, Nhà cung cấp, {{ reference }}, {{ merchandise.name }}.

Những lỗi thường gặp cần tránh

1. Sử dụng dấu ngoặc nhọn đơn thay vì dấu ngoặc nhọn kép

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

2. Nhầm lẫn giữa product và tour trong tên biến

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

TicketingHub sử dụng product — đây là lỗi cú pháp phổ biến nhất mà chúng tôi gặp.

3. Tin tưởng cú pháp tag do AI tạo ra

ChatGPT và Gemini có thể đề xuất định dạng Liquid Tag không khớp với cách triển khai của TicketingHub. Khi hiển thị, hãy kiểm tra nhãn Liquid Supported và đối chiếu đề xuất với các ví dụ trên trang này.

4. Sử dụng Liquid Tags mà không kiểm tra khả năng hỗ trợ

Hãy tìm nhãn Liquid Supported hoặc sử dụng tin nhắn đặt vé hay đặt voucher được hỗ trợ hoặc phần chân trang của vé. Xem trước kết quả trước khi xuất bản.

5. Biến không khả dụng trong loại email đó

Một số biến chỉ khả dụng trong các loại email cụ thể. Nếu tag không hiển thị, hãy kiểm tra phần Email nào hỗ trợ từng Tag ở trên — biến đó có thể không được hỗ trợ trong email này.

Đơn giản hóa Liquid Tags

Liquid Tags có thể nghe khá kỹ thuật, nhưng một khi đã quen với chúng, bạn sẽ thấy đây là công cụ thay đổi đáng kể cách vận hành. Chúng đặc biệt phù hợp với các đơn vị vận hành bận rộn muốn tự động hóa việc giao tiếp mà vẫn giữ được tính cá nhân.

Nếu bạn không chắc nên cấu trúc một tag như thế nào, chúng tôi luôn sẵn sàng hỗ trợ — hãy liên hệ với chúng tôi!