অ্যানালিটিক্স ডেটা পান
অ্যানালিটিক্স ডেটা পান (Get analytics data) অ্যাকশনটি একটি ShopifyQL কোয়েরি রান করে এবং আপনার ওয়ার্কফ্লোতে ব্যবহার করার জন্য ফলাফল রিটার্ন করে। ShopifyQL হলো কমার্স অ্যানালিটিক্সের জন্য তৈরি করা একটি কোয়েরি ল্যাঙ্গুয়েজ। আপনি এটি দিয়ে নির্দিষ্ট সময়কাল অনুযায়ী মেট্রিক একত্র করতে, ফিল্টার প্রয়োগ করতে এবং পণ্য, কালেকশন বা গ্রাহকের মতো ডাইমেনশনের ভিত্তিতে গ্রুপ করতে পারেন। এই অ্যাকশনের মাধ্যমে রিটার্ন করা ডেটা পরবর্তী ধাপের শর্ত ও অ্যাকশনগুলোতে পাওয়া যায়।
ট্রিগার
অ্যানালিটিক্স ডেটা পান (Get analytics data) অ্যাকশনটি শুধুমাত্র নির্ধারিত সময়ের (Scheduled time) ট্রিগারের সাথে সামঞ্জস্যপূর্ণ। ইভেন্ট-ভিত্তিক ট্রিগারে অ্যানালিটিক্স ডেটা অন্তর্ভুক্ত থাকে না।
কনফিগারেশন
ফিল্ড
অ্যানালিটিক্স ডেটা পান (Get analytics data) অ্যাকশনে নিম্নলিখিত ফিল্ডটি আছে:
| ফিল্ড | বিবরণ |
|---|---|
| ShopifyQL কোয়েরি | আবশ্যক। আপনার স্টোরের অ্যানালিটিক্স ডেটায় রান করার জন্য ShopifyQL কোয়েরি। |
ShopifyQL কোয়েরি
আপনি sales, sessions, inventory এবং payments-এর মতো সমর্থিত স্কিমা ব্যবহার করে যেকোনো বৈধ ShopifyQL কোয়েরি লিখতে পারেন। উদাহরণস্বরূপ, নিচের কোয়েরিটি যে দিনে ওয়ার্কফ্লো রান করে সেদিনের মোট বিক্রয় এবং গ্রাহকের সংখ্যা রিটার্ন করে:
FROM sales
SHOW total_sales, customers
SINCE todayসমর্থিত স্কিমা, ফাংশন এবং সিনট্যাক্স সহ সম্পূর্ণ ল্যাঙ্গুয়েজ রেফারেন্সের জন্য, ShopifyQL ডকুমেন্টেশন দেখুন।
ওয়ার্কফ্লো সেভ করার সময় কোয়েরি যাচাই করা হয়। আপনার স্টোরে কোয়েরি সফলভাবে রান না হওয়া পর্যন্ত ওয়ার্কফ্লো অ্যাক্টিভেট করা যায় না।
রিটার্ন করা ডেটা
অ্যানালিটিক্স ডেটা পান (Get analytics data) অ্যাকশন আপনার কোয়েরির সাথে মেলে এমন সারিগুলো রিটার্ন করে, যা getAnalyticsData নামের একটি ভেরিয়েবল হিসেবে পাওয়া যায়। সারিগুলো getAnalyticsData.rows-এ স্টোর করা থাকে, যেখানে প্রতিটি সারি হলো এমন একটি অবজেক্ট যা আপনার কোয়েরির কলামের নাম অনুযায়ী সাজানো থাকে।
আপনি পরবর্তী ধাপের শর্ত এবং অ্যাকশন উভয় ক্ষেত্রেই এই ভেরিয়েবলটি ব্যবহার করতে পারেন। উদাহরণস্বরূপ, প্রতিটি সারির তালিকা সম্বলিত একটি অভ্যন্তরীণ ইমেইল পাঠাতে, আপনি এর মতো একটি Liquid ব্যবহার করতে পারেন:
{% for row in getAnalyticsData.rows %}
* {{ row.total_sales }} in sales from {{ row.customers }} customers
{% endfor %}প্রতিটি সারি নিয়ে আলাদাভাবে কাজ করতে, যেমন প্রতিটি সারির জন্য একটি অ্যাকশন প্রয়োগ করতে, আপনি getAnalyticsData.rows-এর সাথে for each লুপ (ইটারেট) (For each loop (iterate)) অ্যাকশনটি ব্যবহার করতে পারেন। মানগুলো একত্র করতে, যেমন সারিগুলো গণনা করা বা কোনো কলাম যোগ করা, আপনি Count এবং Sum অ্যাকশন ব্যবহার করতে পারেন।
API রেফারেন্স
এই অ্যাকশনে ব্যবহার করা API সম্পর্কে আরও তথ্যের জন্য, GraphQL Admin API-তে থাকা shopifyqlQuery কোয়েরিটি দেখুন।
কোয়েরির জটিলতা
প্রতিটি ShopifyQL কোয়েরিতে একটি জটিলতার খরচ থাকে, যা স্কিমা, কলাম, ফিল্টার এবং কোয়েরি ব্যবহার করার সময়সীমা অনুযায়ী হিসাব করা হয়। যদি কোনো কোয়েরি জটিলতার সীমা অতিক্রম করে, তবে অ্যাকশনটি ব্যর্থ হয় এবং ওয়ার্কফ্লো চালু করা যায় না। কোয়েরির খরচ কমাতে, আপনি সময়সীমা কমাতে পারেন, কলাম বা জয়েন সরাতে পারেন।
কোয়েরির খরচ কীভাবে হিসাব করা হয় এবং বর্তমান সীমা সম্পর্কে বিস্তারিত জানতে, Rate limiting in the ShopifyQL Admin API দেখুন।