Lấy dữ liệu khách hàng
Trong các dòng công việc sử dụng dữ liệu khách hàng, bạn có thể dùng thao tác Lấy dữ liệu khách hàng để lấy thông tin khách hàng từ cửa hàng.
Cấu hình
Trường
Thao tác Lấy dữ liệu khách hàng chứa các trường sau để xây dựng truy vấn:
| Trường | Mô tả |
|---|---|
| Sắp xếp dữ liệu theo | Bắt buộc. Các tham số để sắp xếp dữ liệu được truy vấn tìm kiếm trả về. |
| Số lượng kết quả tối đa | Bắt buộc. Số lượng kết quả tối đa mà truy vấn tìm kiếm bạn chọn có thể trả về. Bạn có thể trả về tối đa 100 kết quả cùng một lúc. |
| Truy vấn | Bắt buộc. Chọn trong các truy vấn phổ biến hoặc chọn Nâng cao để tạo truy vấn của riêng bạn. |
Chuỗi truy vấn
Đây là truy vấn ví dụ để lấy những khách hàng đã được cập nhật vào ngày hôm trước:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Biến updated_at là bộ lọc có sẵn trong truy vấn Khách hàng và có thể được sử dụng nhiều lần hoặc kết hợp với các biến khác. Biến Liquid scheduledAt khả dụng trên các dòng công việc đã sử dụng yếu tố kích hoạt Thời gian đã lên lịch. Thẻ Liquid date_minus là thẻ Flow đặc biệt cho phép bạn trừ đi thời gian từ một ngày cụ thể.
Khi truy vấn dữ liệu, bạn cần biết những thông tin hữu ích sau:
- Danh sách các bộ lọc khách hàng có sẵn
- Truy vấn phải tuân theo cú pháp nhất định
- Các giá trị trường truy vấn không phải lúc nào cũng có tài liệu. Trong một số trường hợp, bạn có thể tìm thấy các giá trị này bằng cách xem tài liệu API. Bạn cũng có thể thường xuyên tìm thấy các giá trị trường trong URL của bảng điều khiển quản trị khi lọc. Ví dụ: để tìm một số giá trị truy vấn Đơn hàng, hãy lọc trang Đơn hàng trong bảng điều khiển quản trị, sau đó kiểm tra URL.
- Bạn có thể chạy hoặc thử nghiệm truy vấn trong cửa hàng bằng ứng dụng Shopify GraphiQL.
- Hãy chú ý đến những gì sẽ xảy ra nếu truy vấn không thành công. Thông thường, API sẽ trả về tất cả kết quả (thay vì không có gì).
Dữ liệu được trả về
Tất cả các thao tác Lấy dữ liệu đều trả về danh sách từ 0 đến 100 tài nguyên. Tùy thuộc vào trường hợp sử dụng, bạn có thể sử dụng dữ liệu này theo nhiều cách khác nhau:
- Nếu cần xử lý riêng từng mục trong danh sách, chẳng hạn như gắn thẻ cho mỗi mục, bạn có thể sử dụng thao tác Cho mỗi.
- Nếu cần tổng hợp dữ liệu, chẳng hạn như đếm số lượng kết quả được trả về, bạn có thể sử dụng thao tác Đếm hoặc Tính tổng.
- Nếu cần xuất danh sách, chẳng hạn như gửi email chứa tất cả các mục, bạn có thể sử dụng trực tiếp dữ liệu được trả về trong các thao tác tiếp theo.
Để truy cập dữ liệu được trả về trong các bước tiếp theo sau thao tác này, hãy sử dụng biến có tên Lấy dữ liệu khách hàng. Đây là một danh sách khách hàng. Bạn có thể sử dụng biến này trong cả điều kiện và thao tác. Ví dụ: bạn có thể gửi danh sách đơn hàng qua thao tác Gửi email nội bộ như sau:
{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}Yếu tố kích hoạt
Bạn có thể sử dụng thao tác này trong bất kỳ dòng công việc nào, bao gồm cả yếu tố kích hoạt Thời gian đã lên lịch. Trong dòng công việc sử dụng yếu tố kích hoạt Thời gian đã lên lịch, dòng công việc sẽ bắt đầu vào một thời gian do bạn chỉ định, thay vì là kết quả của một sự kiện. Vì không có sự kiện cụ thể nào trong cửa hàng hoặc từ một ứng dụng làm bắt đầu dòng công việc, nên không có dữ liệu nào tự động được đưa vào.
Chi tiết API
Mẫu
Chuyển đổi trường siêu dữ liệu của khách hàng thành thẻ cho tất cả khách hàng
Dòng công việc này sẽ bổ sung dữ liệu thẻ cho tất cả khách hàng dựa trên giá trị trường siêu dữ liệu. Dòng công việc này chạy hằng giờ và truy xuất tối đa 100 khách hàng không có thẻ "processed" (đã xử lý). Đối với mỗi khách hàng, dòng công việc này sẽ xem xét giá trị của trường siêu dữ liệu custom.test và thêm giá trị đó thành thẻ. Dòng công việc này cũng thêm thẻ "processed" để kết quả không bị trả về trong lần chạy theo lịch trình tiếp theo của dòng công việc. Để sử dụng dòng công việc, bạn cần thay đổi không gian tên và khóa của trường siêu dữ liệu cho khớp với một trường siêu dữ liệu trong cửa hàng. Xem mẫu
Xóa khách hàng không hoạt động
Xóa những khách hàng trên 5 năm tuổi chưa từng đặt hàng. Xem mẫu