मदद
लॉग इन करें

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

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

इस पेज पर

ट्रिगर

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

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

फ़ील्ड

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

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

ShopifyQL क्वेरी

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

FROM sales
  SHOW total_sales, customers
  SINCE today

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

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

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

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

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

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

हर एक पंक्ति पर अलग-अलग काम करने के लिए, जैसे कि हर पंक्ति पर कोई एक्शन लागू करना, आप getAnalyticsData.rows के साथ प्रत्येक लूप के लिए (दोहराएं) एक्शन का इस्तेमाल कर सकते हैं। मानों को इकट्ठा करने के लिए, जैसे कि पंक्तियों की गिनती करना या किसी स्तंभ का योग करना, आप गिनती और योग एक्शन का इस्तेमाल कर सकते हैं।

API संदर्भ

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

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

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

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