Analiz verilerini al

Analiz verilerini al işlemi, bir ShopifyQL sorgusu çalıştırır ve sonuçları iş akışınızda kullanılmak üzere döndürür. ShopifyQL, ticaret analizleri için oluşturulmuş bir sorgu dilidir. Metrikleri zaman dilimlerine göre toplamak, filtreler uygulamak ve ürün, koleksiyon veya müşteri gibi boyutlara göre gruplandırmak için bu dili kullanabilirsiniz. Bu işlemin döndürdüğü veriler, adımı izleyen koşullar ve işlemler için kullanılabilir.

İpucu

ShopifyQL aynı zamanda Shopify raporlarınızda ve müşteri segmentasyonu işlemlerinde de kullanılır. ShopifyQL sorguları ve söz dizimi hakkında daha fazla bilgi edinebilirsiniz.

Tetikleyiciler

Analiz verilerini al işlemi yalnızca Planlanan zaman tetikleyicisi ile uyumludur. Analiz verileri, olaya dayalı tetikleyiciler tarafından dahil edilmez.

Yapılandırma

Alanlar

Analiz verilerini al işlemi aşağıdaki alanı içerir:

Analiz verilerini al işleminde kullanılan alanlar.

Alan	Açıklama
ShopifyQL sorgusu	Gerekli. Mağazanızın analiz verilerinde çalıştırılacak ShopifyQL sorgusu.

ShopifyQL sorgusu

sales, sessions, inventory ve payments gibi desteklenen şemaları kullanarak geçerli herhangi bir ShopifyQL sorgusu yazabilirsiniz. Örneğin, aşağıdaki sorgu iş akışının çalıştığı gün için toplam satış tutarını ve müşteri sayısını döndürür:

FROM sales
  SHOW total_sales, customers
  SINCE today

Desteklenen şemalar, işlevler ve söz dizimi dahil olmak üzere dil referansının tamamı için ShopifyQL belgelerine bakın.

Sorgu, iş akışını kaydettiğinizde doğrulanır. Sorgu mağazanızda başarılı bir şekilde çalıştırılana kadar iş akışı etkinleştirilemez.

Döndürülen veriler

Analiz verilerini al işlemi, sorgunuzla eşleşen ve getAnalyticsData adlı bir değişken olarak sunulan satırları döndürür. Satırlar getAnalyticsData.rows içinde depolanır ve burada her satır sorgunuzdaki sütun adlarıyla anahtarlanmış bir nesnedir.

Bu değişkeni, adımı izleyen hem koşullarda hem de işlemlerde kullanabilirsiniz. Örneğin, her bir satırı listeleyen dahili bir e-posta göndermek için buna benzer bir şekilde Liquid kullanabilirsiniz:

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

Her bir satır için işlem uygulamak gibi her satırla ayrı ayrı çalışmak üzere, getAnalyticsData.rows ile Her bir döngü için (yinele) işlemini kullanabilirsiniz. Satırları saymak veya bir sütunu toplamak gibi değerleri kümelemek için Say ve Topla işlemlerini kullanabilirsiniz.

Not

Tek bir iş akışında Veri al işlemi birden fazla kez kullanılırsa değişken adına bir sayı eklenir. Örneğin, Sipariş verilerini al işlemini iki kez kullanan bir iş akışında, döndürülen veriler için ilk değişken getOrderData, ikinci değişken ise getOrderData1 olur. Bu ad özelleştirilemez.

API referansı

Bu işlemde kullanılan API hakkında daha fazla bilgi için GraphQL Admin API içindeki shopifyqlQuery sorgusuna bakın.

Sorgu karmaşıklığı

Her bir ShopifyQL sorgusunun; sorgunun kullandığı şemalardan, sütunlardan, filtrelerden ve zaman aralığından hesaplanan bir karmaşıklık maliyeti vardır. Bir sorgu karmaşıklık sınırını aşarsa işlem başarısız olur ve iş akışı etkinleştirilemez. Bir sorgunun maliyetini azaltmak için zaman aralığını kısaltabilir, sütunları kaldırabilir veya birleştirmeleri kaldırabilirsiniz.

Sorgu maliyetinin nasıl hesaplandığı ve mevcut sınırlar hakkında ayrıntılı bilgi için ShopifyQL Admin API'sinde hız sınırlaması bölümüne bakın.