Ambil data pelanggan
Dalam alur kerja yang menggunakan data pelanggan, Anda dapat menggunakan tindakan Ambil data pelanggan untuk mengambil informasi pelanggan dari toko Anda.
Konfigurasi
Kolom
Tindakan Ambil data pelanggan berisi kolom-kolom berikut, yang digunakan untuk membuat kueri:
| Kolom | Deskripsi |
|---|---|
| Urutkan data menurut | Wajib. Parameter yang digunakan untuk mengurutkan data yang dikembalikan oleh kueri pencarian. |
| Jumlah hasil maksimum | Wajib diisi. Jumlah hasil maksimum yang dapat ditampilkan oleh kueri pencarian yang Anda pilih. Anda dapat menampilkan hingga 100 hasil sekaligus. |
| Kueri | Wajib diisi. Pilih dari kueri umum atau pilih Lanjutan untuk membuat kueri Anda sendiri. |
String Kueri
Ini adalah contoh kueri untuk mendapatkan pelanggan yang diperbarui dalam sehari terakhir:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Variabel updated_at adalah filter yang tersedia di kueri pelanggan dan dapat digunakan beberapa kali atau digabungkan dengan variabel lain. Variabel Liquid scheduledAt tersedia di alur kerja yang menggunakan pemicu Waktu terjadwal. Tag Liquid date_minus adalah tag Flow khusus yang memungkinkan Anda mengurangi waktu dari tanggal.
Saat membuat kueri data, ada baiknya Anda mengetahui:
- Daftar filter pelanggan yang tersedia
- Kueri harus mengikuti sintaksis tertentu
- Nilai bidang kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilainya dapat ditemukan dengan melihat dokumen API. Sebagai alternatif, Anda sering kali dapat menemukan nilai bidang di URL pada panel admin saat Anda memfilter. Misalnya, untuk menemukan beberapa nilai kueri Pesanan, filter halaman Pesanan di panel admin, lalu periksa URL.
- Anda dapat menjalankan atau menguji kueri di toko Anda menggunakan aplikasi Shopify GraphiQL.
- Perhatikan apa yang terjadi jika kueri Anda gagal. Sering kali API akan menampilkan semua hasil (alih-alih tidak ada).
Data yang ditampilkan
Semua tindakan Ambil data menampilkan daftar yang berisi antara 0 hingga 100 sumber daya. Bergantung pada kasus penggunaan Anda, Anda mungkin ingin menggunakan data ini dengan berbagai cara:
- Jika Anda perlu menangani setiap item daftar satu per satu, seperti untuk menambahkan tag ke setiap item, maka Anda dapat menggunakan tindakan Untuk setiap.
- Jika Anda perlu menggabungkan data, seperti menghitung jumlah hasil yang ditampilkan, maka Anda dapat menggunakan tindakan Hitung atau Jumlahkan.
- Jika Anda perlu menampilkan daftar sebagai output, misalnya untuk mengirim email berisi semua item, maka Anda dapat menggunakan data yang ditampilkan secara langsung di tindakan berikutnya.
Untuk mengakses data yang ditampilkan dalam langkah-langkah setelah tindakan ini, gunakan variabel bernama Ambil data pelanggan, yang merupakan daftar pelanggan. Anda dapat menggunakan variabel ini dalam kondisi dan tindakan. Misalnya, Anda dapat mengirim daftar pesanan dalam tindakan Kirim email internal seperti ini:
{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}Pemicu
Anda dapat menggunakan tindakan ini di alur kerja apa pun, termasuk pemicu Waktu terjadwal. Dalam alur kerja yang menggunakan pemicu Waktu terjadwal, alur kerja dimulai pada waktu yang telah Anda tentukan, bukan sebagai akibat dari suatu peristiwa. Karena tidak ada peristiwa spesifik di toko Anda atau dari aplikasi yang memulai alur kerja, tidak ada data yang disertakan secara otomatis.
Detail API
Templat
Mengonversi metafield pelanggan menjadi tag untuk semua pelanggan
Alur kerja ini akan melakukan pengisian ulang tag ke semua pelanggan Anda berdasarkan nilai metafield. Alur kerja ini berjalan setiap jam dan mengambil hingga 100 pelanggan yang tidak memiliki tag "diproses". Untuk setiap pelanggan, alur kerja ini akan melihat nilai metafield custom.test dan menambahkannya sebagai tag. Alur kerja juga menambahkan tag "diproses" agar tidak ditampilkan dalam eksekusi terjadwal berikutnya dari alur kerja tersebut. Untuk menggunakan alur kerja ini, Anda harus mengubah ruang nama dan kunci metafield agar cocok dengan metafield di toko Anda. Lihat templat
Hapus pelanggan yang tidak aktif
Hapus pelanggan yang berusia lebih dari 5 tahun yang belum pernah membuat pesanan. Lihat templat