Dapatkan data analisis

Tindakan Dapatkan data analisis menjalankan pertanyaan ShopifyQL dan mengembalikan hasilnya untuk digunakan dalam aliran kerja anda. ShopifyQL ialah bahasa pertanyaan yang dibina untuk analisis perdagangan. Anda boleh menggunakannya untuk mengagregatkan metrik merentasi tempoh masa, menggunakan penapis dan mengumpulkan mengikut dimensi seperti produk, koleksi atau pelanggan. Data yang dikembalikan oleh tindakan ini tersedia untuk syarat dan tindakan yang mengikuti langkah tersebut.

Petua

ShopifyQL juga digunakan dalam laporan Shopify dan pensegmenan pelanggan anda. Anda boleh mengetahui lebih lanjut tentang pertanyaan dan sintaks ShopifyQL.

Pencetus

Tindakan Dapatkan data analisis hanya serasi dengan pencetus Masa dijadualkan. Data analisis tidak disertakan oleh pencetus berasaskan acara.

Konfigurasi

Medan

Tindakan Dapatkan data analisis mengandungi medan yang berikut:

Medan yang digunakan dalam tindakan Dapatkan data analisis.

Medan	Penerangan
Pertanyaan ShopifyQL	Diperlukan. Pertanyaan ShopifyQL untuk dijalankan terhadap data analisis kedai anda.

Pertanyaan ShopifyQL

Anda boleh menulis apa-apa pertanyaan ShopifyQL yang sah menggunakan skema yang disokong, seperti sales, sessions, inventory dan payments. Sebagai contoh, pertanyaan yang berikut mengembalikan jumlah jualan dan bilangan pelanggan bagi hari aliran kerja dijalankan:

FROM sales
  SHOW total_sales, customers
  SINCE today

Untuk mendapatkan rujukan penuh bahasa, termasuk skema, fungsi dan sintaks yang disokong, rujuk dokumentasi ShopifyQL.

Pertanyaan disahkan apabila anda menyimpan aliran kerja. Aliran kerja tidak boleh diaktifkan sehingga pertanyaan berjaya dijalankan terhadap kedai anda.

Data yang dikembalikan

Tindakan Dapatkan data analisis mengembalikan baris yang sepadan dengan pertanyaan anda yang tersedia sebagai pemboleh ubah bernama getAnalyticsData. Baris disimpan dalam getAnalyticsData.rows dan dalam hal ini, setiap baris ialah objek dengan kekunci berdasarkan nama lajur dalam pertanyaan anda.

Anda boleh menggunakan pemboleh ubah ini dalam kedua-dua syarat dan tindakan yang mengikuti langkah tersebut. Sebagai contoh, untuk menghantar e-mel dalaman yang menyenaraikan setiap baris, anda boleh menggunakan Liquid yang serupa dengan hal ini:

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

Untuk bekerja dengan setiap baris secara berasingan, seperti mengenakan tindakan untuk setiap baris, anda boleh menggunakan tindakan Untuk setiap gelung (lelaran) dengan getAnalyticsData.rows. Untuk mengagregatkan nilai seperti mengira baris atau menjumlahkan lajur, anda boleh menggunakan tindakan Kiraan dan Jumlah.

Nota

Jika tindakan Dapatkan data digunakan beberapa kali dalam aliran kerja tunggal, maka satu nombor akan ditambahkan pada nama pemboleh ubah tersebut. Sebagai contoh, dalam aliran kerja yang menggunakan tindakan Dapatkan data pesanan sebanyak dua kali, pemboleh ubah pertama untuk data yang dikembalikan ialah getOrderData dan pemboleh ubah kedua ialah getOrderData1. Nama ini tidak boleh disesuaikan.

Rujukan API

Untuk mendapatkan maklumat lanjut tentang API yang digunakan dalam tindakan ini, rujuk pertanyaan shopifyqlQuery dalam GraphQL Admin API.

Kerumitan pertanyaan

Setiap pertanyaan ShopifyQL mempunyai kos kerumitan yang dikira daripada skema, lajur, penapis dan julat masa yang digunakan oleh pertanyaan tersebut. Jika pertanyaan melebihi had kerumitan, maka tindakan itu gagal dan aliran kerja tidak boleh diaktifkan. Untuk mengurangkan kos pertanyaan, anda boleh memendekkan julat masa, mengalih keluar lajur atau mengalih keluar cantuman.

Untuk mendapatkan butiran tentang cara kos pertanyaan dikira serta had semasa, rujuk Pengehadan kadar dalam ShopifyQL Admin API.