Preview Modal — xem trước khối trong modal
PreviewModal — là modal chung cho tất cả các màn hình cài đặt Wave-2, hiển thị kết quả hoạt động của khối trong thời gian thực. Modal được mở bằng nút «Open in modal» trên các màn hình cài đặt.
Tại sao điều này cần thiết
Khi bạn cấu hình một khối (chiến lược, bộ lọc, đối tượng) — bạn muốn ngay lập tức hiểu những sản phẩm nào sẽ xuất hiện trong kết quả với những cài đặt như vậy. PreviewModal cho phép bạn kiểm tra điều này mà không cần công bố khối trên trang web và không cần chuyển đổi giữa admin và frontend.
Tab Basic — danh sách sản phẩm
Tab đầu tiên — Basic. Hiển thị bảng sản phẩm mà API sẽ trả về với các cài đặt hiện tại của khối:
- Tải dữ liệu bằng infinite scroll thông qua thành phần
NewBlockPreviewTable. - Trong bảng — xem trước thẻ sản phẩm (tên, hình ảnh, nhãn, siêu dữ liệu ngắn).
- Danh sách tự động được cập nhật khi thay đổi cài đặt khối trên màn hình cha.
Tab Investigate — chẩn đoán
Tab thứ hai — Investigate — cần thiết cho việc gỡ lỗi. Tại đây bạn có thể thấy những gì đã xảy ra "sau cánh gà" khi tạo ra kết quả:
| Trường | Ý nghĩa |
|---|---|
| appliedAudienceRule | Quy tắc đối tượng nào đã được áp dụng cho yêu cầu hiện tại. Xem Bộ lọc Đối tượng. |
| warnings | Chẩn đoán — ví dụ, "tập hợp thuộc tính trống", "fallback đã chọn sản phẩm không thuộc danh mục đã chọn". |
| fallbackUsed | Cờ: liệu có sử dụng đường dẫn fallback (hiển thị sản phẩm xu hướng dự phòng) hay không. |
| contextEcho | Echo của ngữ cảnh yêu cầu — những gì hệ thống thực sự nhận được (user ID, giỏ hàng, danh mục đã chọn, v.v.). |
Nếu backend không trả về một trường nào đó — phần tương ứng trong Investigate sẽ bị ẩn đi, không có lỗi. Điều này được thực hiện để phát triển API một cách không đau đớn.
Simulated user ID — xem trước "từ tên" người dùng
Dưới trường Preview có một ô nhập Simulated user ID. Nhập ID của bất kỳ người dùng nào — xem trước sẽ xây dựng kết quả như thể yêu cầu đến từ họ. Tiện lợi để:
- Kiểm tra các gợi ý cá nhân (Gợi ý cá nhân, Mua lại) cho một khách hàng cụ thể;
- Tái hiện khiếu nại kiểu "trong khối của tôi không có những sản phẩm đó" — nhập ID của h ọ và xem họ sẽ thấy gì.
Nếu không chỉ định Simulated user ID, xem trước sẽ sử dụng ngữ cảnh admin của bạn, và đối với các khối cá nhân hóa, kết quả có thể trống hoặc không liên quan.
Quyền truy cập blocks.preview
Quyền truy cập vào endpoint admin của xem trước khối được kiểm soát bởi quyền riêng biệt blocks.preview trong cây quyền.
Điều này cho phép:
- Cấp vai trò chỉnh sửa khối, không có quyền truy cập vào xem trước (ví dụ, cho các quản lý nội dung "chỉ-đối tượng").
- Ẩn dữ liệu nhạy cảm khỏi một số admin, có thể được tiết lộ qua Investigate (ngữ cảnh yêu cầu, echo của các tham số).
Đối với các nhà phát triển và QA — luôn cấp blocks.preview. Đối với các quản lý nội dung — chỉ khi họ cần thấy kết quả thực tế của khối trước khi công bố.