Ambil data diskon

Dalam alur kerja yang memerlukan data diskon, Anda dapat menggunakan tindakan Ambil data diskon untuk mengambil informasi diskon dari toko Anda.

Konfigurasi

Bidang

Tindakan Ambil data diskon berisi bidang-bidang berikut, yang digunakan untuk menyusun kueri:

Bidang yang digunakan dalam tindakan Ambil data.
BidangDeskripsi
Urutkan data menurutWajib diisi. Parameter yang digunakan untuk mengurutkan data yang ditampilkan oleh kueri pencarian.
Jumlah hasil maksimumWajib diisi. Jumlah hasil maksimum yang dapat ditampilkan oleh kueri pencarian yang Anda pilih. Anda dapat menampilkan hingga 100 hasil sekaligus.
KueriWajib diisi. Pilih dari kueri umum atau pilih Lanjutan untuk membuat kueri Anda sendiri.

String Kueri

Ini adalah contoh kueri untuk mendapatkan diskon aktif yang menggunakan kode:

method:code AND status:active

Variabel method dan status adalah filter yang tersedia di kueri simpul Diskon dan dapat digunakan beberapa kali atau digabungkan dengan variabel lain.

Saat membuat kueri data, ada baiknya Anda mengetahui:

  • Daftar filter diskon yang tersedia.
  • Kueri harus mengikuti sintaksis tertentu
  • Nilai bidang kueri tidak selalu didokumentasikan. Dalam beberapa kasus, nilai dapat ditemukan dengan melihat dokumentasi API. Atau, Anda sering kali dapat menemukan nilai bidang di URL di 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 dengan menggunakan aplikasi Shopify GraphiQL.
  • Waspadai apa yang terjadi jika kueri Anda gagal. Sering kali, API akan mengembalikan semua hasil (alih-alih tidak ada hasil sama sekali).

Data yang dikembalikan

Semua tindakan Dapatkan data mengembalikan daftar yang berisi antara 0 hingga 100 sumber daya. Bergantung pada kasus penggunaan, Anda mungkin ingin menggunakan data ini dengan berbagai cara:

  • Jika Anda perlu menangani setiap item daftar satu per satu, misalnya untuk menambahkan tag ke setiap item, Anda dapat menggunakan tindakan Untuk setiap.
  • Jika Anda perlu menggabungkan data, seperti menghitung berapa banyak hasil yang dikembalikan, Anda dapat menggunakan tindakan Hitung atau Jumlahkan.
  • Jika Anda perlu meneruskan daftar tersebut, misalnya untuk mengirim email berisi semua item, maka Anda dapat langsung menggunakan data yang dikembalikan di tindakan berikutnya.

Untuk mengakses data yang dikembalikan pada langkah-langkah setelah tindakan ini, gunakan variabel bernama Dapatkan data diskon, yang merupakan daftar diskon. Anda dapat menggunakan variabel ini dalam kondisi maupun tindakan. Misalnya, Anda dapat mengirim daftar diskon aplikasi otomatis dalam tindakan Kirim email internal seperti ini:

{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
*  {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% 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 hasil dari suatu peristiwa. Karena tidak ada peristiwa tertentu di toko Anda atau dari aplikasi yang memulai alur kerja, tidak ada data yang disertakan secara otomatis.

Detail API

Templat

Email ringkasan mingguan tentang diskon aktif yang menggunakan kode

Mengirim email berisi ringkasan diskon aktif yang menggunakan kode. Alur kerja berjalan sesuai jadwal setiap hari Senin pukul 09.00. Alur kerja dapat disesuaikan untuk mengubah waktu, cara Anda menerima ringkasan, jenis diskon yang ingin Anda sertakan, dan mode. Lihat templat