Dapatkan data analitik

Tindakan Dapatkan data analitik menjalankan kueri ShopifyQL dan mengembalikan hasilnya untuk digunakan dalam alur kerja Anda. ShopifyQL adalah bahasa kueri yang dibuat untuk analitik perdagangan. Anda dapat menggunakannya untuk mengagregasi metrik di seluruh periode waktu, menerapkan filter, dan mengelompokkan berdasarkan dimensi seperti produk, koleksi, atau pelanggan. Data yang dikembalikan oleh tindakan ini tersedia untuk kondisi dan tindakan setelah langkah tersebut.

Kiat

ShopifyQL juga digunakan dalam laporan Shopify dan segmentasi pelanggan Anda. Anda dapat mempelajari selengkapnya tentang kueri dan sintaks ShopifyQL.

Pemicu

Tindakan Dapatkan data analitik hanya kompatibel dengan pemicu Waktu terjadwal. Data analitik tidak disertakan oleh pemicu berbasis peristiwa.

Konfigurasi

Bidang

Tindakan Dapatkan data analitik berisi bidang berikut:

Bidang yang digunakan dalam tindakan Dapatkan data analitik.

Bidang	Deskripsi
Kueri ShopifyQL	Wajib. Kueri ShopifyQL yang akan dijalankan terhadap data analitik toko Anda.

Kueri ShopifyQL

Anda dapat menulis kueri ShopifyQL apa pun yang valid menggunakan skema yang didukung, seperti sales, sessions, inventory, dan payments. Misalnya, kueri berikut mengembalikan total penjualan dan jumlah pelanggan pada hari saat alur kerja dijalankan:

FROM sales
  SHOW total_sales, customers
  SINCE today

Untuk referensi bahasa selengkapnya, termasuk skema, fungsi, dan sintaksis yang didukung, lihat dokumentasi ShopifyQL.

Kueri divalidasi saat Anda menyimpan alur kerja. Alur kerja tidak dapat diaktifkan sampai kueri berhasil dijalankan terhadap toko Anda.

Data yang dikembalikan

Tindakan Dapatkan data analitik mengembalikan baris yang cocok dengan kueri Anda, tersedia sebagai variabel dengan nama getAnalyticsData. Baris tersebut disimpan dalam getAnalyticsData.rows, di mana masing-masing baris merupakan objek yang dikunci oleh nama kolom dalam kueri Anda.

Anda dapat menggunakan variabel ini di dalam kondisi serta tindakan setelah langkah tersebut. Misalnya, untuk mengirimkan email internal yang menampilkan daftar masing-masing baris, Anda dapat menggunakan Liquid yang mirip seperti ini:

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

Untuk mengolah setiap baris secara individu, seperti menerapkan tindakan untuk setiap baris, Anda dapat menggunakan tindakan Perulangan for each (iterasi) dengan getAnalyticsData.rows. Untuk mengagregasi nilai, seperti menghitung baris atau menjumlahkan kolom, Anda dapat menggunakan tindakan Hitung dan Jumlahkan.

Catatan

Jika tindakan Dapatkan data digunakan berkali-kali dalam satu alur kerja, sebuah angka akan ditambahkan ke nama variabel. Misalnya, pada alur kerja yang menggunakan tindakan Dapatkan data pesanan dua kali, variabel pertama untuk data yang dikembalikan adalah getOrderData dan variabel keduanya adalah getOrderData1. Nama ini tidak dapat disesuaikan.

Referensi API

Untuk informasi selengkapnya tentang API yang digunakan dalam tindakan ini, lihat kueri shopifyqlQuery di GraphQL Admin API.

Kompleksitas kueri

Setiap kueri ShopifyQL memiliki biaya kompleksitas yang dihitung dari skema, kolom, filter, dan rentang waktu yang digunakan oleh kueri. Jika kueri melebihi batas kompleksitas, maka tindakan akan gagal dan alur kerja tidak dapat diaktifkan. Untuk mengurangi biaya kueri, Anda dapat mempersingkat rentang waktu, menghapus kolom, atau menghapus penggabungan.

Untuk perincian tentang cara penghitungan biaya kueri serta batas yang ada saat ini, lihat Pembatasan laju di ShopifyQL Admin API.