Analiz verilerini al

Analiz verilerini al eylemi 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 dilimleri bazında toplamak, filtreler uygulamak ve ürün, koleksiyon veya müşteri gibi boyutlara göre gruplandırmak için bunu kullanabilirsiniz. Bu eylem tarafından döndürülen veriler, adımı izleyen koşullar ve eylemler için kullanılabilir.

İpucu

ShopifyQL, Shopify raporlarınızda ve müşteri segmentasyonunda da kullanılır. ShopifyQL sorguları ve söz dizimi hakkında daha fazla bilgi edinebilirsiniz.

Tetikleyiciler

Analiz verilerini al eylemi yalnızca Planlanan zaman tetikleyicisi ile uyumludur. Olay tabanlı tetikleyicilere analiz verileri dahil edilmez.

Yapılandırma

Alanlar

Analiz verilerini al eylemi şu alanı içerir:

Analiz verilerini al eyleminde 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 tüm ShopifyQL sorgularını 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 tam dil referansı için ShopifyQL belgelerine bakın.

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

Döndürülen veriler

Analiz verilerini al eylemi, sorgunuzla eşleşen satırları döndürür. Bu satırlar, getAnalyticsData adlı bir değişken olarak kullanılabilir. Satırlar, her satırın sorgunuzdaki sütun adlarıyla anahtarlanmış bir nesne olduğu getAnalyticsData.rows içinde depolanır.

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

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

Her satır için bir eylem uygulamak gibi satırlarla ayrı ayrı çalışmak üzere, getAnalyticsData.rows ile Her döngü için (yinele) eylemini kullanabilirsiniz. Satırları saymak veya bir sütunu toplamak gibi değerleri birleştirmek için Say ve Topla eylemlerini kullanabilirsiniz.

Not

Bir Verileri al eylemi tek bir iş akışında birden çok kez kullanılıyorsa değişken adına bir sayı eklenir. Örneğin, Sipariş verilerini al eylemini 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 eylemde kullanılan API hakkında daha fazla bilgi için GraphQL Admin API'sindeki shopifyqlQuery sorgusuna bakın.

Sorgu karmaşıklığı

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

Sorgu maliyetinin nasıl hesaplandığına ve mevcut sınırlara ilişkin ayrıntılar için ShopifyQL Admin API'sinde hız sınırlaması bölümüne bakın.