Dapatkan data pelanggan
Dalam aliran kerja yang menggunakan data pelanggan, anda boleh menggunakan tindakan Dapatkan data pelanggan untuk mengambil semula maklumat pelanggan daripada kedai anda.
Pada halaman ini
Konfigurasi
Medan
Tindakan Dapatkan data pelanggan mengandungi medan yang berikut, yang digunakan untuk membina pertanyaan:
| Medan | Huraian |
|---|---|
| Isih data mengikut | Diperlukan. Parameter yang digunakan untuk mengisih data yang dipulangkan oleh pertanyaan carian. |
| Bilangan hasil maksimum | Diperlukan. Jumlah maksimum hasil yang boleh dipulangkan oleh pertanyaan carian yang anda pilih. Anda boleh memulangkan sehingga 100 pada satu-satu masa. |
| Pertanyaan | Diperlukan. Pilih daripada pertanyaan biasa atau pilih Lanjutan untuk mencipta pertanyaan anda sendiri. |
Rentetan Pertanyaan
Ini ialah contoh pertanyaan bagi mendapatkan pelanggan yang telah dikemas kini pada hari sebelumnya:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Pemboleh ubah updated_at ialah penapis yang tersedia pada Pertanyaan pelanggan dan boleh digunakan berbilang kali atau digabungkan dengan pemboleh ubah yang lain. Pemboleh ubah Liquid scheduledAt tersedia pada aliran kerja yang menggunakan Pencetus masa yang dijadualkan. Tag Liquid date_minus ialah tag Flow yang istimewa yang membenarkan anda untuk menolak masa daripada sesuatu tarikh.
Mengetahui perkara yang berikut berguna apabila anda menanyakan data:
- Senarai penapis pelanggan yang tersedia
- Pertanyaan mesti mengikuti sintaks tertentu
- Nilai medan pertanyaan tidak sentiasa didokumenkan. Dalam sesetengah kes, nilai tersebut boleh didapati dengan melihat Dokumen API. Sebagai alternatif, anda juga sering menemui nilai medan ini dalam URL di panel pentadbir apabila anda membuat penapisan. Contohnya, untuk mencari sesetengah nilai pertanyaan Pesanan, tapis halaman Pesanan pada panel pentadbir, kemudian semak URL tersebut.
- Anda boleh menjalankan atau menguji pertanyaan di kedai anda dengan menggunakan aplikasi Shopify GraphiQL.
- Beri perhatian kepada perkara yang berlaku jika pertanyaan anda gagal. Selalunya, API akan memulangkan semua hasil (berbanding tiada hasil langsung).
Data yang dipulangkan
Semua tindakan Dapatkan data memulangkan senarai mana-mana sumber antara 0 dan 100. Bergantung pada kes penggunaan anda, anda mungkin mahu menggunakan data ini dengan pelbagai cara:
- Jika anda perlu mengendalikan setiap item senarai secara berasingan, seperti untuk menambah tag pada setiap daripadanya, maka anda boleh menggunakan tindakan Untuk setiap.
- Jika anda perlu mengagregatkan data, seperti mengira bilangan hasil yang telah dipulangkan, maka anda boleh menggunakan tindakan Kira atau Jumlah.
- Jika anda perlu mengeluarkan senarai tersebut, seperti menghantar e-mel yang mengandungi semua item, maka anda boleh menggunakan data yang dipulangkan secara terus dalam tindakan yang seterusnya.
Untuk mengakses data yang dipulangkan dalam langkah-langkah yang mengikut tindakan ini, gunakan pemboleh ubah yang dinamakan Dapatkan data pelanggan, iaitu senarai pelanggan. Anda boleh menggunakan pemboleh ubah ini dalam keadaan dan tindakan. Contohnya, anda boleh menghantar senarai pesanan dalam tindakan Hantar e-mel dalaman seperti ini:
{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}Pencetus
Anda boleh menggunakan tindakan ini dalam mana-mana aliran kerja, termasuk pencetus Masa yang dijadualkan. Dalam aliran kerja yang menggunakan pencetus Masa yang dijadualkan, aliran kerja bermula pada masa yang telah anda tetapkan, bukannya akibat daripada peristiwa. Oleh sebab tiada peristiwa khusus dalam kedai anda atau daripada aplikasi yang memulakan aliran kerja tersebut, tiada data yang disertakan secara automatik.
Butiran API
Templat
Tukar medan meta pelanggan menjadi tag bagi semua pelanggan
Aliran kerja ini akan melakukan pengisian semula tag pada semua pelanggan anda berdasarkan nilai medan meta. Aliran ini dijalankan setiap jam dan mengambil sehingga 100 pelanggan yang tidak mempunyai tag "processed". Untuk setiap pelanggan, aliran ini melihat nilai medan meta custom.test dan menambahkannya sebagai tag. Aliran kerja ini juga menambahkan tag "processed" supaya tag tidak dipulangkan dalam aliran kerja yang dijadualkan untuk dijalankan yang seterusnya. Untuk menggunakan aliran kerja tersebut, anda perlu menukar ruang nama dan kunci medan meta tersebut untuk memadankan medan meta yang terdapat dalam kedai anda. Lihat templat
Padamkan pelanggan yang tidak aktif
Padamkan pelanggan yang melebihi 5 tahun yang tidak pernah membuat pesanan. Lihat templat