Trợ giúp
Đăng nhập

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

Hành động 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 thiết kế dành cho dữ liệu phân tích thương mại điện tử. Có thể sử dụng ngôn ngữ này để tổng hợp số liệu theo khoảng thời gian, áp dụng bộ lọc và nhóm theo các phương diện như sản phẩm, bộ sưu tập hoặc khách hàng. Dữ liệu mà hành động này trả về có sẵn đối với các điều kiện và hành động diễn ra sau bước này.

Trên trang này

Yếu tố kích hoạt

Hành động 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 đã lên lịch. Dữ liệu phân tích không có trong các yếu tố kích hoạt dựa trên sự kiện.

Cấu hình

Trường

Hành động Lấy dữ liệu phân tích chứa trường sau:

Các trường được sử dụng trong hành động 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 trên dữ liệu phân tích của cửa hàng.

Truy vấn ShopifyQL

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

FROM sales
  SHOW total_sales, customers
  SINCE today

Để xem toàn bộ tài liệu tham khảo ngôn ngữ, bao gồm 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 được xác thực khi lưu dòng công việc. Không thể kích hoạt dòng công việc cho đến khi truy vấn chạy thành công trên cửa hàng.

Dữ liệu được trả về

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

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

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

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

Tài liệu tham khảo API

Để biết thêm thông tin về API dùng trong hành động 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 có một chi phí độ phức tạp được tính từ các lược đồ, cột, bộ lọc và khoảng thời gian mà truy vấn sử dụng. Nếu một truy vấn vượt quá giới hạn độ phức tạp, hành động sẽ thất bại và không thể kích hoạt dòng công việc. Để giảm chi phí của truy vấn, có thể rút ngắn khoảng thời gian, xóa cột hoặc xóa phép nối.

Để 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.