اینالیٹکس ڈیٹا حاصل کریں

Get analytics data ایکشن ایک ShopifyQL query چلاتا ہے اور آپ کے ورک فلو میں استعمال کے لیے نتائج واپس کرتا ہے۔ ShopifyQL ایک query لینگویج ہے جو کامرس اینالیٹکس کے لیے بنائی گئی ہے۔ آپ اسے مختلف ادوار میں میٹرکس جمع کرنے، فلٹرز لاگو کرنے، اور پراڈکٹ، کلیکشن، یا کسٹمر جیسی dimensions کے لحاظ سے گروپ بنانے کے لیے استعمال کر سکتے ہیں۔ اس ایکشن کے ذریعے واپس کیا گیا ڈیٹا ان شرائط اور ایکشنز کے لیے دستیاب ہوتا ہے جو اس مرحلے کے بعد آتے ہیں۔

ٹپ

ShopifyQL آپ کی Shopify رپورٹس اور کسٹمر segmentation میں بھی استعمال ہوتا ہے۔ آپ ShopifyQL queries اور syntax کے بارے میں مزید جان سکتے ہیں۔

ٹرگرز

Get analytics data ایکشن صرف Scheduled time ٹرگر کے ساتھ ہم آہنگ ہے۔ ایونٹ پر مبنی ٹرگرز کے ذریعے اینالیٹکس ڈیٹا شامل نہیں کیا جاتا ہے۔

کنفیگریشن

فیلڈز

Get analytics data ایکشن میں درج ذیل فیلڈ شامل ہے:

Get analytics data ایکشن میں استعمال ہونے والے فیلڈز۔

فیلڈ	تفصیل
ShopifyQL Query	مطلوب ہے۔ آپ کے سٹور کے اینالیٹکس ڈیٹا کے خلاف چلانے کے لیے ShopifyQL query۔

ShopifyQL query

آپ معاونت یافتہ سکیماز، جیسے کہ sales، sessions، inventory، اور payments کا استعمال کرتے ہوئے کوئی بھی درست ShopifyQL query لکھ سکتے ہیں۔ مثال کے طور پر، درج ذیل query اس دن کے لیے کل سیلز اور کسٹمرز کی تعداد واپس کرتی ہے جس دن ورک فلو چلتا ہے:

FROM sales
  SHOW total_sales, customers
  SINCE today

زبان کے مکمل حوالے کے لیے، بشمول معاونت یافتہ سکیماز، فنکشنز، اور syntax، ShopifyQL کی دستاویزات سے رجوع کریں۔

جب آپ ورک فلو کو محفوظ کرتے ہیں تو query کی توثیق کی جاتی ہے۔ ورک فلو اس وقت تک فعال نہیں کیا جا سکتا جب تک کہ query آپ کے سٹور کے خلاف کامیابی سے نہ چل جائے۔

واپس کیا گیا ڈیٹا

Get analytics data ایکشن آپ کی query سے مماثل قطاریں (rows) واپس کرتا ہے، جو getAnalyticsData نامی متغیر کے طور پر دستیاب ہیں۔ قطاریں getAnalyticsData.rows میں محفوظ کی جاتی ہیں، جہاں ہر قطار ایک آبجیکٹ ہے جو آپ کی query میں کالم کے ناموں سے منسلک (keyed) ہوتی ہے۔

آپ اس متغیر کو ان شرائط اور ایکشنز دونوں میں استعمال کر سکتے ہیں جو اس مرحلے کے بعد آتے ہیں۔ مثال کے طور پر، ایک اندرونی ای میل بھیجنے کے لیے جس میں ہر قطار کی فہرست ہو، آپ اس طرح کا Liquid استعمال کر سکتے ہیں:

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

ہر قطار کے ساتھ انفرادی طور پر کام کرنے کے لیے، جیسے کہ ہر قطار کے لیے ایک ایکشن لاگو کرنا، آپ getAnalyticsData.rows کے ساتھ For each لوپ (iterate) ایکشن استعمال کر سکتے ہیں۔ ویلیوز کو جمع کرنے کے لیے، جیسے قطاریں گننا یا کالم کا مجموعہ نکالنا، آپ Count اور Sum ایکشنز استعمال کر سکتے ہیں۔

نوٹ

اگر ایک ہی ورک فلو میں Get data ایکشن ایک سے زیادہ بار استعمال کیا جاتا ہے، تو متغیر کے نام میں ایک عدد شامل کر دیا جاتا ہے۔ مثال کے طور پر، ایسے ورک فلو میں جو Get order data ایکشن کو دو بار استعمال کرتا ہے، واپس کیے گئے ڈیٹا کا پہلا متغیر getOrderData ہوتا ہے اور دوسرا متغیر getOrderData1 ہوتا ہے۔ اس نام کو حسب ضرورت نہیں بنایا جا سکتا۔

API کا حوالہ

اس ایکشن میں استعمال ہونے والی API کے بارے میں مزید معلومات کے لیے، GraphQL Admin API میں موجود shopifyqlQuery کوئری دیکھیں۔

کوئری کی پیچیدگی

ہر ShopifyQL کوئری کی پیچیدگی کی لاگت ہوتی ہے جس کا حساب ان سکیما، کالم، فلٹر اور وقت کی حد سے لگایا جاتا ہے جنہیں کوئری استعمال کرتی ہے۔ اگر کوئی کوئری پیچیدگی کی حد سے تجاوز کر جاتی ہے، تو ایکشن ناکام ہو جاتا ہے اور ورک فلو کو فعال نہیں کیا جا سکتا۔ کوئری کی لاگت کم کرنے کے لیے، آپ وقت کی حد کم کر سکتے ہیں، کالم ہٹا سکتے ہیں، یا جوائن ہٹا سکتے ہیں۔

کوئری کی لاگت کا حساب لگانے کے طریقے اور موجودہ حدود کے بارے میں تفصیلات کے لیے، ShopifyQL Admin API میں شرح کو محدود کرنا دیکھیں۔