Sử dụng SHOPLINE QL để Tùy chỉnh Báo cáo Phân tích

SHOPLINE QL là một ngôn ngữ truy vấn phân tích giúp bạn xây dựng các báo cáo tùy chỉnh linh hoạt hơn trong SHOPLINE. Với SHOPLINE QL, bạn có thể chọn các chỉ số muốn phân tích, lọc dữ liệu báo cáo, nhóm kết quả theo các chiều, và tạo các chỉ số tùy chỉnh với các phép tính đơn giản.

Hướng dẫn này giới thiệu các thuật ngữ phổ biến của SHOPLINE QL, cấu trúc truy vấn cơ bản, các mệnh đề thường dùng, ví dụ truy vấn và các lưu ý quan trọng khi sử dụng.

Hiểu các Thuật ngữ Phổ biến của SHOPLINE QL

Trước khi sử dụng các ví dụ trong hướng dẫn này, bạn có thể thấy hữu ích khi hiểu các thuật ngữ phổ biến sau của SHOPLINE QL:

Hiểu Cấu trúc của một Truy vấn SHOPLINE QL

Một truy vấn SHOPLINE QL bao gồm các mệnh đề. Mỗi mệnh đề cho SHOPLINE biết dữ liệu nào cần truy vấn, các trường nào sẽ hiển thị, cách lọc hoặc nhóm kết quả, và khoảng thời gian sử dụng.

Khi tạo báo cáo tùy chỉnh với SHOPLINE QL, mỗi truy vấn nên bao gồm:

• FROM: Chỉ định dataset.
• VIEW: Chỉ định các trường, chỉ số hoặc giá trị tính toán để hiển thị.
• Một khoảng thời gian: Sử dụng DURING, hoặc sử dụng SINCE / UNTIL để chỉ định phạm vi ngày.

Một truy vấn SHOPLINE QL điển hình có thể trông như sau:

FROM sales
  VIEW total_sales, order_cnt
  FILTER payment_status IN ('Payment successful', 'Unpaid')
  GROUP BY day
  DURING last_30_day
  COMPARE previous_period
  EXTEND TOTALS
  ORDER BY total_sales DESC
  LIMIT 20

Bảng dưới đây tóm tắt các mệnh đề SHOPLINE QL có sẵn và mục đích của chúng. Nhấp vào tên mệnh đề để chuyển đến phần riêng biệt của nó để xem chi tiết và ví dụ.

Cấu hình SHOPLINE QL trong Báo cáo Tùy chỉnh

Bạn có thể nhập và chạy SHOPLINE QL khi tạo hoặc chỉnh sửa báo cáo tùy chỉnh. Sử dụng trình soạn thảo SHOPLINE QL để viết truy vấn của bạn, sau đó chạy để xem trước kết quả báo cáo trước khi lưu.

Để cấu hình SHOPLINE QL trong báo cáo tùy chỉnh:

1. Từ trang quản trị SHOPLINE của bạn, đi tới Phân tích > Báo cáo.
2. Nhấp vào Tạo báo cáo tùy chỉnh để tạo báo cáo mới, hoặc mở báo cáo tùy chỉnh hiện có để chỉnh sửa.
3. Nhập tên báo cáo. Tên báo cáo phải là duy nhất. Nếu tên đã tồn tại, hệ thống sẽ yêu cầu bạn đổi tên.
4. Chọn một bộ dữ liệu từ danh sách thả xuống. Hiện tại, các báo cáo tùy chỉnh mới chỉ hỗ trợ dữ liệu Bán hàng.
5. Nhấp Tiếp theo, sau đó trong trình soạn thảo báo cáo, nhập truy vấn SHOPLINE QL của bạn vào trình soạn thảo SHOPLINE QL.
6. Nhấp Chạy để xem trước kết quả báo cáo.
7. Xem lại bản xem trước. Nếu kết quả đúng, lưu báo cáo.

Sử dụng các Mệnh đề SHOPLINE QL trong Truy vấn

Các phần sau đây giải thích các mệnh đề SHOPLINE QL được sử dụng phổ biến nhất, bao gồm mục đích, cú pháp và ví dụ sử dụng.

FROM và VIEW

FROM chỉ định bộ dữ liệu bạn muốn truy vấn. VIEW chỉ định các trường, chỉ số hoặc giá trị tính toán bạn muốn hiển thị trong báo cáo.

Ví dụ, để xem doanh số hôm nay:

FROM sales
  VIEW total_sales
  DURING today

Bạn cũng có thể hiển thị nhiều chỉ số trong cùng một báo cáo:

FROM sales
  VIEW total_sales, net_sales, order_cnt
  DURING last_7_day

Để tạo một chỉ số mới dựa trên các chỉ số hiện có, sử dụng các toán tử số học trong VIEW, sau đó dùng AS để đặt tên cho chỉ số mới.

Ví dụ, để tính giá trị đơn hàng trung bình:

FROM sales
  VIEW (net_sales / order_cnt) AS average_order_value
  DURING last_month

Ví dụ, để tính doanh số điều chỉnh dựa trên doanh số gộp và chiết khấu:

FROM sales
  VIEW (gross_sales - discounts) AS adjusted_sales
  DURING last_month

SHOPLINE QL hỗ trợ các toán tử số học sau:

Khi một trường tính toán chứa nhiều toán tử, phép nhân và phép chia được tính trước phép cộng và phép trừ. Bạn cũng có thể sử dụng dấu ngoặc để kiểm soát thứ tự tính toán.

Ví dụ, để tính doanh số đã điều chỉnh trước, sau đó chia kết quả cho số lượng đơn hàng:

FROM sales
  VIEW ((gross_sales - discounts) / order_cnt) AS average_adjusted_sales
  DURING last_month

BỘ LỌC

FILTER thu hẹp dữ liệu trước khi các chỉ số được tính toán. Bạn có thể sử dụng nó để chỉ bao gồm các bản ghi phù hợp với trạng thái, sản phẩm, vị trí hoặc các điều kiện khác cụ thể.

Ví dụ, để chỉ xem doanh số với các thanh toán thành công:

FROM sales
  VIEW total_sales
  FILTER payment_status IN ('Payment successful')
  DURING today

Ví dụ, để xem doanh số cho các sản phẩm có tên chứa shirt:

FROM sales
  VIEW total_sales, order_cnt
  FILTER product_spu_name CONTAINS ('shirt')
  DURING last_30_day

FILTER hỗ trợ các toán tử so sánh sau:

Ví dụ, để chỉ bao gồm các bản ghi có doanh số lớn hơn 100:

FROM sales
  VIEW total_sales
  FILTER total_sales > 100
  DURING last_30_day

Bạn cũng có thể sử dụng AND, OR, và NOT để kết hợp nhiều điều kiện lọc, hoặc sử dụng IN, NOT IN, CONTAINS, và NOT CONTAINS để khớp với các giá trị cụ thể.

Ví dụ, để bao gồm các thanh toán thành công và loại trừ các loại khách hàng được chọn:

FROM sales
  VIEW total_sales
  FILTER (payment_status IN ('Payment successful')) AND NOT buyer_type IN ('New customer', 'Returning customer')
  DURING today

Ví dụ, để loại trừ các đơn hàng có trạng thái đơn hàng cụ thể:

FROM sales
  VIEW total_sales
  FILTER order_status NOT IN ('Completed', 'Shipped')
  DURING today

POSTFILTER

POSTFILTER lọc kết quả sau khi các chỉ số được tính toán. Điều này hữu ích khi bạn muốn nhóm dữ liệu trước, sau đó chỉ giữ lại các kết quả nhóm đáp ứng các điều kiện nhất định.

Ví dụ, để xem doanh số theo bang/tỉnh trong 30 ngày qua và chỉ hiển thị các địa điểm có doanh số lớn hơn 1000:

FROM sales
  VIEW total_sales
  GROUP BY province
  DURING last_30_day
  POSTFILTER total_sales > 1000

FILTER và POSTFILTER được áp dụng ở các giai đoạn khác nhau. FILTER lọc dữ liệu gốc trước khi các chỉ số được tính toán. POSTFILTER lọc kết quả đã tính toán sau khi các chỉ số được tạo ra.

Ví dụ, nếu bạn muốn tính doanh số cho mỗi bang/tỉnh trước, sau đó chỉ hiển thị các địa điểm có doanh số đạt một mức cụ thể, hãy sử dụng POSTFILTER.

GROUP BY

GROUP BY nhóm dữ liệu báo cáo theo chiều. Nếu không có GROUP BY, báo cáo thường trả về kết quả tổng hợp. Sau khi bạn thêm GROUP BY, báo cáo sẽ phân tách kết quả theo các chiều bạn chỉ định.

Ví dụ, để xem doanh số theo ngày trong 30 ngày qua:

FROM sales
  VIEW total_sales
  GROUP BY day
  DURING last_30_day

Ví dụ, để xem doanh số theo bang/tỉnh và thành phố trong 30 ngày qua:

FROM sales
  VIEW total_sales
  GROUP BY province, city
  DURING last_30_day

Các chiều thời gian phổ biến bao gồm:

DURING, SINCE, và UNTIL

Mỗi truy vấn SHOPLINE QL nên bao gồm một khoảng thời gian. Sử dụng DURING để chọn khoảng thời gian đã đặt sẵn, hoặc sử dụng SINCE và UNTIL để chỉ định ngày chính xác.

Để sử dụng khoảng thời gian đã đặt sẵn:

FROM sales
  VIEW total_sales
  DURING last_30_day

Để sử dụng khoảng thời gian ngày cụ thể:

FROM sales
  VIEW total_sales
  SINCE '2026-05-01' UNTIL '2026-05-31'

Để chỉ định cả ngày và giờ:

FROM sales
  VIEW total_sales
  SINCE '2026-05-01 00:00:00' UNTIL '2026-05-31 23:59:59'

Các khoảng thời gian DURING phổ biến bao gồm:

SO SÁNH

COMPARE so sánh khoảng thời gian được chọn với một khoảng thời gian khác.

Ví dụ, để so sánh dữ liệu trong 30 ngày gần nhất với khoảng thời gian trước đó:

FROM sales
  VIEW total_sales
  GROUP BY day
  DURING last_30_day
  COMPARE previous_period

Hiện tại các loại so sánh được hỗ trợ bao gồm:

MỞ RỘNG TỔNG

EXTEND TOTALS thêm tổng hợp tóm tắt vào kết quả báo cáo. Điều này hữu ích khi bạn nhóm dữ liệu theo địa điểm, sản phẩm hoặc một chiều khác và cũng muốn xem tổng cộng chung.

Ví dụ, để xem doanh số theo bang/tỉnh trong 30 ngày gần nhất và bao gồm tổng hợp tóm tắt:

FROM sales
  VIEW total_sales, order_cnt
  GROUP BY province
  DURING last_30_day
  EXTEND TOTALS

SẮP XẾP THEO, GIỚI HẠN và BỎ QUA

ORDER BY sắp xếp kết quả. LIMIT kiểm soát số hàng được trả về bởi truy vấn. OFFSET bỏ qua một số hàng nhất định và thường được sử dụng cùng với LIMIT.

Ví dụ, để xem 10 sản phẩm hàng đầu theo doanh số trong 30 ngày qua:

FROM sales
  VIEW total_sales, order_cnt
  GROUP BY product_spu_name
  DURING last_30_day
  ORDER BY total_sales DESC
  LIMIT 10

ASC sắp xếp kết quả từ thấp đến cao. DESC sắp xếp kết quả từ cao đến thấp.

Để bỏ qua 40 dòng đầu tiên và xem 20 dòng tiếp theo:

FROM sales
  VIEW total_sales
  GROUP BY product_spu_name
  DURING last_30_day
  ORDER BY total_sales DESC
  LIMIT 20
  OFFSET 40

FROM sales
  VIEW total_sales, order_cnt
  GROUP BY product_spu_name
  DURING last_30_day
  ORDER BY total_sales DESC
  LIMIT 10

FROM sales
  VIEW total_sales, net_sales
  GROUP BY day
  DURING last_30_day
  COMPARE previous_period
  ORDER BY day ASC
  LIMIT 30

FROM sales
  VIEW total_sales, order_cnt
  FILTER product_spu_name CONTAINS ('shirt')
  GROUP BY product_spu_name
  DURING last_7_day
  ORDER BY total_sales DESC
  LIMIT 20

FROM sales
  VIEW total_sales, order_cnt
  GROUP BY province
  DURING this_month
  EXTEND TOTALS
  ORDER BY total_sales DESC
  LIMIT 50

FROM sales
  VIEW total_sales
  GROUP BY province
  DURING last_30_day
  POSTFILTER total_sales > 1000

FROM sales
  VIEW total_sales
  FILTER payment_status IN ('success', 'failed')
  SINCE '2026-05-01 00:00:00' UNTIL '2026-05-20 23:59:59'