एनालिटिक्स डेटा प्राप्त करें

एनालिटिक्स डेटा प्राप्त करें एक्शन एक ShopifyQL क्वेरी चलाता है और आपके वर्कफ़्लो में उपयोग करने के लिए नतीजे लौटाता है। ShopifyQL कॉमर्स एनालिटिक्स के लिए बनाई गई एक पूछताछ की भाषा है। आप इसका उपयोग समयावधियों में मीट्रिक को एग्रीगेट करने, फ़िल्टर लागू करने और प्रोडक्ट, संग्रहण या ग्राहक जैसे डाइमेंशन के आधार पर ग्रुप बनाने के लिए कर सकते हैं। इस एक्शन द्वारा लौटाया गया डेटा इस चरण के बाद आने वाली शर्तों और एक्शन के लिए उपलब्ध होता है।

ट्रिगर

एनालिटिक्स डेटा प्राप्त करें एक्शन केवल निर्धारित समय ट्रिगर के साथ संगत है। इवेंट-आधारित ट्रिगर द्वारा एनालिटिक्स डेटा शामिल नहीं किया जाता है।

कॉन्फ़िगरेशन

फ़ील्ड

एनालिटिक्स डेटा प्राप्त करें एक्शन में निम्नलिखित फ़ील्ड शामिल है:

एनालिटिक्स डेटा प्राप्त करें एक्शन में उपयोग किए गए फ़ील्ड।
फ़ील्डविवरण
ShopifyQL क्वेरीज़रूरी है। आपके स्टोर के एनालिटिक्स डेटा के लिए चलाई जाने वाली ShopifyQL क्वेरी।

ShopifyQL क्वेरी

आप sales, sessions, inventory और payments जैसे समर्थित स्कीमा का उपयोग करके कोई भी मान्य ShopifyQL क्वेरी लिख सकते हैं। उदाहरण के लिए, निम्नलिखित क्वेरी वर्कफ़्लो चलने के दिन के लिए कुल बिक्री और ग्राहकों की संख्या लौटाती है:

FROM sales
  SHOW total_sales, customers
  SINCE today

समर्थित स्कीमा, फ़ंक्शन और सिंटैक्स सहित पूरे भाषा संदर्भ के लिए, ShopifyQL दस्तावेज़ देखें।

जब आप वर्कफ़्लो सेव करते हैं, तो क्वेरी को वैलिडेट किया जाता है। जब तक आपके स्टोर के लिए क्वेरी सफलतापूर्वक नहीं चल जाती, तब तक वर्कफ़्लो को सक्रिय नहीं किया जा सकता।

लौटाया गया डेटा

एनालिटिक्स डेटा प्राप्त करें एक्शन आपकी क्वेरी से मेल खाने वाली पंक्तियों (row) को लौटाता है, जो getAnalyticsData नामक वेरिएबल के रूप में उपलब्ध होती हैं। पंक्तियां getAnalyticsData.rows में स्टोर की जाती हैं, जहाँ प्रत्येक पंक्ति एक ऑब्जेक्ट होती है जिसकी की (key) आपकी क्वेरी में मौजूद स्तंभ के नाम होते हैं।

आप इस वेरिएबल का उपयोग इस चरण के बाद आने वाली शर्तों और एक्शन दोनों में कर सकते हैं। उदाहरण के लिए, प्रत्येक पंक्ति को सूचीबद्ध करने वाला आंतरिक ईमेल भेजने के लिए, आप इस तरह के Liquid का उपयोग कर सकते हैं:

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

प्रत्येक पंक्ति के साथ अलग-अलग काम करने के लिए, जैसे कि प्रत्येक पंक्ति के लिए कोई एक्शन लागू करना, आप getAnalyticsData.rows के साथ For each loop (iterate) एक्शन का उपयोग कर सकते हैं। वैल्यू को एग्रीगेट करने के लिए, जैसे कि पंक्तियों की गिनती करना या किसी स्तंभ का योग करना, आप Count और Sum एक्शन का उपयोग कर सकते हैं।

API संदर्भ

इस एक्शन में उपयोग किए गए API के बारे में अधिक जानकारी के लिए, GraphQL Admin API में shopifyqlQuery क्वेरी देखें।

क्वेरी की जटिलता

प्रत्येक ShopifyQL क्वेरी की एक जटिलता लागत (complexity cost) होती है जिसकी गणना क्वेरी द्वारा उपयोग किए जाने वाले स्कीमा, स्तंभों, फ़िल्टर और समय सीमा से की जाती है। यदि कोई क्वेरी जटिलता सीमा से अधिक हो जाती है, तो एक्शन विफल हो जाता है और वर्कफ़्लो को सक्रिय नहीं किया जा सकता है। किसी क्वेरी की लागत को कम करने के लिए, आप समय सीमा को छोटा कर सकते हैं, स्तंभों को हटा सकते हैं या जॉइन हटा सकते हैं।

क्वेरी की लागत की गणना कैसे की जाती है और वर्तमान सीमाएँ क्या हैं, इस बारे में जानकारी के लिए ShopifyQL Admin API में रेट लिमिटिंग देखें।