Trợ giúp
Đăng nhập

Lấy dữ liệu phân tích

Thao tác Lấy dữ liệu phân tích chạy truy vấn ShopifyQL và trả về kết quả để sử dụng trong dòng công việc. ShopifyQL là ngôn ngữ truy vấn được xây dựng cho mục đích phân tích thương mại điện tử. Bạn có thể sử dụng ngôn ngữ này để tổng hợp số liệu trên các khoảng thời gian, áp dụng bộ lọc và phân nhóm theo các thứ nguyên như sản phẩm, bộ sưu tập hoặc khách hàng. Dữ liệu được trả về qua thao tác này được cung cấp cho các điều kiện và thao tác theo sau bước này.

Trên trang này

Yếu tố kích hoạt

Thao tác Lấy dữ liệu phân tích chỉ tương thích với yếu tố kích hoạt Thời gian theo lịch trình. Các yếu tố kích hoạt dựa trên sự kiện không có kèm theo dữ liệu phân tích.

Cấu hình

Trường

Thao tác Lấy dữ liệu phân tích có chứa trường sau:

Trường dùng trong thao tác Lấy dữ liệu phân tích.
TrườngMô tả
Truy vấn ShopifyQLBắt buộc. Truy vấn ShopifyQL để chạy dựa trên dữ liệu phân tích của cửa hàng.

Truy vấn ShopifyQL

Bạn có thể viết mọi truy vấn ShopifyQL hợp lệ bằng cách sử dụng các lược đồ được hỗ trợ như sales, sessions, inventory và payments. Ví dụ: truy vấn sau đây sẽ trả về tổng doanh số và số lượng khách hàng đối với ngày chạy dòng công việc:

FROM sales
  SHOW total_sales, customers
  SINCE today

Để xem tài liệu tham khảo đầy đủ về ngôn ngữ này, bao gồm cả lược đồ, hàm và cú pháp được hỗ trợ, hãy tham khảo tài liệu về ShopifyQL.

Truy vấn sẽ được xác thực khi bạn lưu dòng công việc. Dòng công việc không thể kích hoạt cho đến khi truy vấn chạy thành công trên cửa hàng.

Dữ liệu trả về

Thao tác Lấy dữ liệu phân tích trả về các hàng khớp với truy vấn của bạn dưới dạng biến có tên getAnalyticsData. Các hàng này được lưu trong getAnalyticsData.rows, trong đó, mỗi hàng là một đối tượng được khóa theo các tên cột trong truy vấn.

Bạn có thể dùng biến này trong cả điều kiện và thao tác theo sau bước này. Ví dụ: để gửi email nội bộ liệt kê từng hàng, bạn có thể dùng Liquid tương tự như sau:

{% for row in getAnalyticsData.rows %}
* {{ row.total_sales }} in sales from {{ row.customers }} customers
{% endfor %}

Để xử lý riêng từng hàng, chẳng hạn như áp dụng thao tác cho mỗi hàng, bạn có thể dùng thao tác Vòng lặp For each (lặp lại) với getAnalyticsData.rows. Để tổng hợp các giá trị, chẳng hạn như đếm số hàng hoặc tính tổng của một cột, bạn có thể dùng các thao tác Đếm và Tính tổng.

Tham chiếu API

Để biết thêm thông tin về API được dùng trong thao tác này, hãy tham khảo truy vấn shopifyqlQuery trong GraphQL Admin API.

Độ phức tạp của truy vấn

Mỗi truy vấn ShopifyQL đều có chi phí về độ phức tạp. Chi phí này được tính dựa trên các lược đồ, cột, bộ lọc và phạm vi thời gian mà truy vấn sử dụng. Nếu truy vấn vượt quá giới hạn độ phức tạp, thao tác sẽ không thực hiện được và không thể kích hoạt dòng công việc. Để giảm chi phí của truy vấn, bạn có thể rút ngắn phạm vi thời gian, xóa cột hoặc xóa liên kết.

Để biết chi tiết về cách tính chi phí truy vấn và các giới hạn hiện tại, hãy tham khảo Giới hạn tốc độ trong ShopifyQL Admin API.