Dapatkan data analitik

Tindakan Dapatkan data analitik mengeksekusi kueri ShopifyQL dan menampilkan hasil untuk digunakan dalam alur kerja Anda. ShopifyQL merupakan bahasa kueri yang dibuat untuk analitik perdagangan. Anda dapat menggunakannya untuk menggabungkan metrik di seluruh periode waktu, menerapkan filter, dan mengelompokkan menurut dimensi seperti produk, koleksi, atau pelanggan. Data yang ditampilkan oleh tindakan ini tersedia untuk kondisi dan tindakan yang mengikuti langkah tersebut.

Tip

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

Kolom

Tindakan Dapatkan data analitik berisi kolom berikut:

Kolom yang digunakan dalam tindakan Dapatkan data analitik.

Kolom	Deskripsi
Kueri ShopifyQL	Wajib. Kueri ShopifyQL yang akan dieksekusi terhadap data analitik toko Anda.

Kueri ShopifyQL

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

FROM sales
  SHOW total_sales, customers
  SINCE today

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

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

Data yang ditampilkan

Tindakan Dapatkan data analitik menampilkan baris yang cocok dengan kueri Anda, yang tersedia sebagai variabel bernama getAnalyticsData. Baris disimpan di getAnalyticsData.rows, tempat setiap baris merupakan objek dengan kunci berdasarkan nama kolom pada kueri Anda.

Anda dapat menggunakan variabel ini di kondisi maupun tindakan yang mengikuti langkah tersebut. Misalnya, untuk mengirim email internal yang mencantumkan setiap baris, Anda dapat menggunakan Liquid yang mirip dengan ini:

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

Untuk menangani setiap baris secara terpisah, seperti menerapkan suatu tindakan untuk tiap baris, Anda dapat menggunakan tindakan Loop for each (iterasi) dengan getAnalyticsData.rows. Untuk menggabungkan nilai, seperti menghitung baris atau menjumlahkan kolom, Anda dapat menggunakan tindakan Hitung dan Jumlahkan.

Catatan

Jika tindakan Dapatkan data digunakan beberapa kali dalam satu alur kerja, angka akan ditambahkan ke nama variabel. Misalnya, dalam alur kerja yang menggunakan tindakan Dapatkan data pesanan dua kali, variabel pertama untuk data yang ditampilkan adalah getOrderData dan variabel kedua adalah getOrderData1. Nama ini tidak dapat disesuaikan.

Referensi API

Untuk mendapatkan informasi selengkapnya mengenai API yang digunakan di 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 kueri tersebut. Jika suatu kueri melampaui 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 gabungan.

Untuk detail selengkapnya tentang cara menghitung biaya kueri serta batas saat ini, lihat Pembatasan laju di ShopifyQL Admin API.