Khung xem trước — cửa sổ xem trước khối
Khung xem trước — cửa sổ xem trước, cho thấy kết quả hoạt động của khối trong thời gian thực. Nó giống nhau trên các màn hình cài đặt của các khối gợi ý và động, và được mở bằng nút «Mở trong modal».
Tại sao điều này cần thiết
Khi bạn cấu hình 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 với những cài đặt như vậy. Khung xem trước cho phép kiểm tra điều này mà không cần công bố khối trên trang web, không cần rời khỏi trang quản trị.
Tab Cơ bản — danh sách sản phẩm
Cửa sổ bao gồm ba tab: Cơ bản | Giải thích | Điều tra.
Tab đầu tiên — Cơ bản. Hiển thị bảng sản phẩm sẽ xuất hiện trong khối với các cài đặt hiện tại:
- Sản phẩm được tải tự động khi cuộn bảng xuống.
- Trong bảng — xem trước thẻ (tên, hình ảnh, nhãn, siêu dữ liệu ngắn).
- Đối với khối Sản phẩm tương tự, xem trước được xây dựng dựa trên khối đã lưu — trên màn hình có gợi ý "Xem trước được tạo dựa trên khối đã lưu — các thay đổi sẽ được áp dụng sau khi lưu". Để thấy kết quả của các chỉnh sửa, trước tiên hãy lưu khối.
Tab Giải thích — tại sao sản phẩm có trong kết quả
Tab thứ hai — Giải thích. Nó trả lời câu hỏi "tại sao sản phẩm này lại có trong khối": dưới mỗi thẻ sản phẩm hiển thị các nhãn với lý do lựa chọn — ví dụ, "Đặt cùng nhau", "Thuộc tính khớp", "Cùng loại", "Trong bảng xếp hạng xu hướng", "Đã xem", "Thay thế vì phổ biến".
Các nhãn được sắp xếp theo ý nghĩa: trước là thay thế kết quả (fallback cho các sản phẩm phổ biến), sau đó là lựa chọn (tại sao sản phẩm lại ở đây), sau đó là xếp hạng (tại sao nó ở vị trí này) và cuối cùng là giảm (ví dụ, "Giảm — chênh lệch giá" — sản phẩm bị hạ do chênh lệch giá).
Giải thích giải thích kết quả cho từng sản phẩm — điều gì đã hoạt động cho thẻ cụ thể. Điều tra cho thấy bức tranh cho toàn bộ yêu cầu — quy tắc đối tượng nào đã được áp dụng, hệ thống đã đưa ra cảnh báo nào, có phải đã kích hoạt fallback không. Nếu không có lý do lựa chọn, tab sẽ hiển thị thông báo dạng "Không có dữ liệu để giải thích" — điều này là bình thường, ví dụ cho một xem trước trống.
Tab Điều tra — chẩn đoán
Tab thứ ba — Điều tra — cần thiết cho việc gỡ lỗi. Tại đây bạn có thể thấy điều gì đã xảy ra "dưới nắp" khi tạo ra kết quả:
| Phần trên màn hình | Ý nghĩa |
|---|---|
| Quy tắc đối tượng đã áp dụng | Quy tắc đối tượng nào đã hoạt động cho yêu cầu hiện tại. Xem Bộ lọc Đối tượng. |
| Cảnh báo | 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 loại đã chọn". |
| Fallback đã sử dụng | Cờ: liệu có phải đã kích hoạt đường dẫn fallback (hiển thị dự phòng các sản phẩm xu hướng). |
| Ngữ cảnh yêu cầu | Ngữ cảnh yêu cầu — những gì hệ thống nhận được khi xây dựng xem trước (ID người dùng, giỏ hàng, các loại đã chọn, v.v.). |
Nếu không có dữ liệu cho một phần nào đó, phần đó sẽ không hiển thị trên tab Điều tra — điều này không phải là lỗi.
Giả lập người dùng (ID) — xem trước "thay mặt" người dùng
Trên màn hình cài đặt khối trong phần Ngữ cảnh cho xem trước, ngữ cảnh được đặt cho việc xây dựng xem trước. Trường này phụ thuộc vào loại khối:
| Loại khối | Trường ngữ cảnh xem trước |
|---|---|
| Xu hướng, Đã xem gần đây, Gợi ý cá nhân, Mua lại | Giả lập người dùng (ID) |
| Bổ sung giỏ hàng, Tương tự giỏ hàng | Giỏ thử nghiệm (ID sản phẩm) |
| Tương tự danh sách mong muốn | Danh sách mong muốn thử nghiệm (ID sản phẩm) |
| Đặt hàng thường xuyên, Sản phẩm tương tự (chế độ tự động) | ID sản phẩm thử nghiệm |
Đối với các khối cá nhân hóa, trường này là Giả lập người dùng (ID) (trong chẩn đoán của tab Điều tra, giá trị này cũng được đề cập là simulatedUserId). 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ọ. Điều này rất tiện lợi để:
- Kiểm tra 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 Giả lập người dùng (ID), xem trước sẽ sử dụng ngữ cảnh quản trị 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 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:
- Cung 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 khỏi một số quản trị viên dữ liệu nhạy cảm có thể được tiết lộ qua Điều tra (phần Ngữ cảnh yêu cầu).
Cung cấp blocks.preview cho những người cấu hình và kiểm tra kết quả của các khối. Chỉ cung cấp cho các quản lý nội dung nếu họ cần thấy kết quả thực tế của khối trước khi công bố.