Dapatkan data analisis

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

Petua

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

Pencetus

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

Konfigurasi

Medan

Tindakan Dapatkan data analisis mengandungi medan yang berikut:

Medan yang digunakan dalam tindakan Dapatkan data analisis.

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

Pertanyaan ShopifyQL

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

FROM sales
  SHOW total_sales, customers
  SINCE today

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

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

Data dikembalikan

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

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

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

Untuk mengendalikan setiap baris secara individu, seperti mengenakan tindakan untuk setiap baris, anda boleh menggunakan tindakan Gelung bagi setiap satu (lelaran) dengan getAnalyticsData.rows. Untuk mengagregat nilai, seperti mengira baris atau menjumlahkan lajur, anda boleh menggunakan tindakan Kira dan Jumlah.

Nota

Jika tindakan Dapatkan data digunakan berbilang kali dalam aliran kerja yang sama, maka satu nombor akan ditambahkan pada nama pemboleh ubah. Sebagai contoh, dalam aliran kerja yang menggunakan tindakan Dapatkan data pesanan sebanyak dua kali, pemboleh ubah pertama bagi 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, tindakan akan 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.