Giao diện
Biến hệ thống trong Dynamic Form
Trang này để làm gì
Hướng dẫn chèn thông tin khách hàng vào nội dung form, để mỗi người mở form đều thấy tên mình, hạng của mình, điểm của mình - thay vì một dòng chữ chung cho tất cả.
Đường dẫn: → → mở form → tab → chọn một thành phần Nội dung.
Mini App phải được deploy sau ngày 25/09/2026
Việc thay biến thành giá trị thật diễn ra bên Mini App, không phải bên CDP. Mini App bản cũ không biết các biến này, nên khách sẽ nhìn thấy nguyên văn chuỗi {customer.point} trên màn hình.
Trước khi kích hoạt form có dùng biến, hãy xác nhận với đội kỹ thuật rằng Mini App của shop đã deploy bản từ 25/09/2026 trở đi.
Chèn biến vào nội dung
+ nằm ở góc dưới bên phải ô nhập.- Chọn thành phần Nội dung Ở cây thành phần bên trái, bấm vào thành phần Nội dung cần sửa. Cột phải hiện ô nhập.
- Đặt con trỏ vào đúng chỗ muốn chèn Biến sẽ được chèn tại vị trí con trỏ. Chưa đặt con trỏ thì biến rơi vào cuối đoạn.
- Bấm dấu
+ở góc ô nhập Danh sách biến hiện ra, mỗi dòng có tên biến và mô tả kết quả hiển thị. - Chọn biến cần chèn Biến hiện thành một thẻ màu có tên dễ đọc, ví dụ Điểm tích lũy, chứ không phải chuỗi thô.
Thẻ biến là một khối nguyên: không sửa được phần chữ bên trong, và xoá là mất cả cụm. Bấm dấu × trên thẻ, hoặc để con trỏ sát thẻ rồi bấm Backspace.
Vì sao không cho sửa bên trong thẻ
Biến chỉ hoạt động khi khớp chính xác từng ký tự. Sửa hụt một chữ là biến chết lặng - Mini App in nguyên văn chuỗi đó ra màn hình khách, còn trình dựng thì không báo gì. Khoá cả cụm là để lỗi đó không xảy ra được.
Danh sách biến
| Biến | Hiển thị ra | Khách chưa có dữ liệu |
|---|---|---|
| Tên | Tên khách | Guest |
| Họ | Họ khách | — |
| Họ và tên | Họ + tên ghép sẵn | Guest |
| Hạng thành viên | Tên hạng hiện tại | — |
| Điểm tích lũy | Số điểm, đã định dạng - ví dụ 1.250 | 0 |
| Điểm xét hạng | Điểm dùng để xét lên hạng, khác điểm tiêu được | 0 |
| Tổng chi tiêu | Có ký hiệu tiền - ví dụ 1.250.000 đ | 0 đ |
| Tổng số đơn hàng | Số đơn đã mua | 0 |
| Số điện thoại | Số điện thoại khách | — |
| Email khách | — | |
| Ngày sinh | Định dạng DD/MM/YYYY | — |
| Giới tính | Nam hoặc Nữ | — |
Khách chưa có dữ liệu thì hiện gì
Không phải ai mở form cũng đã là khách hàng. Có hai nhóm không có dữ liệu:
| Nhóm | Tình huống |
|---|---|
| Khách vãng lai | Mới mở Mini App, chưa chia sẻ số điện thoại |
| Đang đăng ký | Đã xác thực số điện thoại nhưng chưa hoàn tất đăng ký khách hàng |
Với cả hai nhóm, biến không có dữ liệu hiển thị dấu gạch —, không phải chỗ trống. Cột cuối của bảng trên cho biết từng biến ra gì; danh sách trong popup chèn biến cũng ghi sẵn thông tin này ngay dưới tên biến.
Viết câu chịu được dấu gạch
Câu "Hạng hiện tại: {Hạng thành viên}" với khách vãng lai sẽ thành "Hạng hiện tại: —" - đọc được. Nhưng câu "Chúc mừng bạn đã lên hạng {Hạng thành viên}!" thành "Chúc mừng bạn đã lên hạng —!" thì vô nghĩa.
Với nội dung chỉ đúng khi khách đã có dữ liệu, hãy tách riêng thành một Block và đặt điều kiện hiển thị, thay vì trộn vào đoạn văn chung.
Ví dụ
Một form đánh giá dịch vụ dùng biến ở hai chỗ:
Xin chào {Họ và tên}, cảm ơn bạn đã tin tưởng sử dụng dịch vụ qua {Tổng số đơn hàng} đơn hàng vừa qua.
Hạng hiện tại: {Hạng thành viên} Điểm tích lũy: {Điểm tích lũy} Điểm xét hạng: {Điểm xét hạng} Tổng chi tiêu: {Tổng chi tiêu}
Khách hàng thân thiết nhìn thấy:
Xin chào Nguyễn Văn An, cảm ơn bạn đã tin tưởng sử dụng dịch vụ qua 12 đơn hàng vừa qua.
Hạng hiện tại: Vàng Điểm tích lũy: 1.250 Điểm xét hạng: 3.400 Tổng chi tiêu: 12.500.000 đ
Khách vãng lai nhìn thấy:
Xin chào Guest, cảm ơn bạn đã tin tưởng sử dụng dịch vụ qua 0 đơn hàng vừa qua.
Hạng hiện tại: — Điểm tích lũy: 0 Điểm xét hạng: 0 Tổng chi tiêu: 0 đ
Đoạn "qua 0 đơn hàng vừa qua" cho thấy vì sao cần đọc lại câu ở cả hai trạng thái trước khi kích hoạt.
Lỗi thường gặp
| Hiện tượng | Nguyên nhân | Cách xử lý |
|---|---|---|
Khách thấy chuỗi {customer.point} trên màn hình | Mini App chưa deploy bản từ 25/09/2026 | Báo đội kỹ thuật deploy lại Mini App |
| Biến không thay dù Mini App đã mới | Đoạn văn đó không nằm trong thành phần Nội dung | Chuyển đoạn đó sang thành phần Nội dung |
| Xem trước hiện tên biến thay vì giá trị | Đúng như thiết kế | Xem trước luôn hiện nhãn; giá trị thật chỉ có trên Mini App |
Nhiều chỗ hiện dấu — | Khách chưa có dữ liệu | Xem lại câu chữ cho trường hợp này, hoặc tách Block riêng |
Bước tiếp theo
- Trình dựng Dynamic Form - dựng giao diện form
- Dynamic Form - khi nào nên dùng form
- Nguồn dữ liệu - dropdown động lấy từ bảng