ক্যোয়ারী গঠন

মেট্রিক এবং সেগমেন্ট ফিল্ডের জন্য কোয়েরি reports.search মেথডে পাঠানো যেতে পারে। মার্চেন্ট সেন্টার কোয়েরি ল্যাঙ্গুয়েজে একটি কোয়েরি তৈরি করতে, আপনাকে প্রথমে ল্যাঙ্গুয়েজ গ্রামার ব্যবহার করে কোয়েরিটি রচনা করতে হবে। একটি কোয়েরি বেশ কয়েকটি ক্লজ দিয়ে গঠিত হয়:

• SELECT
• FROM
• WHERE
• ORDER BY
• LIMIT

কাঙ্ক্ষিত ডেটা নির্বাচন করতে ক্লজগুলো ফিল্ডের নাম , টেবিলের নাম , অপারেটর , শর্ত এবং ক্রম ব্যবহার করে। এগুলোকে একটি একক কোয়েরিতে একত্রিত করার পর, গুগল কন্টেন্ট এপিআই ফর শপিং ব্যবহার করে একটি অনুরোধ পাঠানো যায়। চলুন দেখে নেওয়া যাক প্রতিটি ক্লজ কীভাবে ব্যবহার করা যেতে পারে।

ধারা

নির্বাচন করুন

SELECT ক্লজটি অনুরোধে আনার জন্য এক সেট ফিল্ড নির্দিষ্ট করে। SELECT সেগমেন্ট ফিল্ড এবং মেট্রিক্সের একটি কমা-বিভক্ত তালিকা গ্রহণ করে এবং প্রতিক্রিয়াতে সেগুলোর মান ফেরত দেয়। একটি কোয়েরিতে SELECT ক্লজ থাকা আবশ্যক ।

এখানে একটি নমুনা কোয়েরি দেওয়া হলো যা একটি প্রদত্ত টেবিল থেকে ক্লিক মেট্রিক্স নির্বাচন করে:

SELECT
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

আপনি একটিমাত্র অনুরোধে বিভিন্ন ধরনের ফিল্ড সম্পর্কেও অনুসন্ধান করতে পারেন:

SELECT
  segments.date,
  segments.program,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

• সেগমেন্ট ক্ষেত্র

  • segments.date
  • segments.program

• মেট্রিক্স

  • metrics.impressions
  • metrics.clicks

নিম্নলিখিত সীমাবদ্ধতার কারণে SELECT ক্লজে কিছু ফিল্ড ব্যবহার করা যায় না:

• অন্তত একটি মেট্রিক ফিল্ড ছাড়া সেগমেন্ট ফিল্ডগুলো কোয়েরি করা।

উপরোক্ত অবস্থা সম্পর্কিত তথ্য আমাদের রেফারেন্স ডকুমেন্টগুলোতে পাওয়া যাবে।

থেকে

FROM ক্লজটি অনুরোধে ডেটা আনার জন্য টেবিল নির্দিষ্ট করে। FROM ক্লজের টেবিলটি নির্ধারণ করে যে প্রদত্ত কোয়েরির জন্য অন্য সব ক্লজ কোন ফিল্ডগুলো ব্যবহার করতে পারবে। FROM ক্লজে শুধুমাত্র একটি টেবিল নির্দিষ্ট করা যায়। বর্তমানে, শুধুমাত্র MerchantPerformanceView টেবিলটি সমর্থিত। reports সার্ভিসের search মেথডে করা কোয়েরিতে FROM ক্লজটি আবশ্যক ।

কোথায়

WHERE ক্লজটি অনুরোধের জন্য ডেটা ফিল্টার করার সময় প্রযোজ্য শর্তাবলী নির্দিষ্ট করে। WHERE ক্লজ ব্যবহার করার সময়, এক বা একাধিক শর্তকে AND দিয়ে আলাদা করে নির্দিষ্ট করা যেতে পারে। প্রতিটি শর্তকে field_name Operator value এই প্যাটার্ন অনুসরণ করতে হবে। যেকোনো সেগমেন্ট ফিল্ড WHERE ক্লজে ব্যবহার করা যেতে পারে, কিন্তু মেট্রিক্স ফিল্ড WHERE ক্লজে ব্যবহার করার জন্য SELECT ক্লজে নির্দিষ্ট করতে হবে। একটি কোয়েরিতে WHERE ক্লজ আবশ্যক , কারণ আপনি কখন আপনার পারফরম্যান্স ডেটা ফেরত পেতে চান তার জন্য আপনাকে সর্বদা তারিখের পরিসীমা নির্দিষ্ট করতে হবে।

একটি নির্দিষ্ট সময়কালের মেট্রিকস পেতে WHERE ব্যবহারের একটি উদাহরণ নিচে দেওয়া হলো:

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

ডেটা ফিল্টার করার জন্য আপনি একাধিক শর্ত একত্রিত করতে পারেন। এই উদাহরণটি SHOPPING_ADS প্রোগ্রামের জন্য প্রতিটি অফারের ক্লিকের সংখ্যা দেখাবে, যেখানে প্রদত্ত ৩০-দিনের সময়কালের মধ্যে ক্লিকের সংখ্যা ১০০-এর বেশি।

SELECT
  segments.offer_id,
  segments.program,
  metrics.clicks
FROM MerchantPerformanceView
WHERE metrics.clicks > 100
  AND segments.program = SHOPPING_ADS
  AND segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’;

নিম্নলিখিত কোয়েরিতে, আপনি লক্ষ্য করবেন যে segments.date নির্বাচন করা হয়েছে। আপনি segments.date নির্বাচন করুন বা না করুন, পারফরম্যান্স ডেটা পুনরুদ্ধার করার জন্য WHERE ক্লজে সর্বদা একটি নির্দিষ্ট তারিখের পরিসর প্রদান করতে হবে।

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

ফিল্টার করার সময় আপনার অপারেটরের কেস-সেনসিটিভিটি মনে রাখা গুরুত্বপূর্ণ।

ল্যাঙ্গুয়েজ গ্রামারে বর্ণিত কোয়েরি স্ট্রিং ব্যবহার করে মেটাডেটা কোয়েরি করার সময় নিম্নলিখিত বিষয়গুলো লক্ষ্য করুন।

ক্রম অনুসারে

ORDER BY ক্লজটি ফলাফল ফেরত দেওয়ার ক্রম নির্দিষ্ট করে। এটি আপনাকে একটি ফিল্ডের নামের উপর ভিত্তি করে ডেটা আরোহী বা অবরোহী ক্রমে সাজানোর সুযোগ দেয়। প্রতিটি ক্রম field_name এর পরে ASC বা DESC দিয়ে নির্দিষ্ট করা হয়। যদি ASC বা DESC কোনোটিই নির্দিষ্ট করা না থাকে, তবে ক্রমটি ডিফল্টভাবে ASC হয়। শুধুমাত্র SELECT ক্লজে নির্দিষ্ট করা ফিল্ডগুলোই ORDER BY ক্লজে ব্যবহার করা যায়। একটি কোয়েরিতে ORDER BY ক্লজটি ঐচ্ছিক ।

নিম্নলিখিত কোয়েরিটি ফেরত আসা সারিগুলিকে ক্লিকের সংখ্যা অনুসারে সর্বোচ্চ থেকে সর্বনিম্ন ক্রমে সাজায়:

SELECT
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.clicks DESC

আপনি ORDER BY ক্লজে কমা দিয়ে আলাদা করা একটি তালিকা ব্যবহার করে একাধিক ফিল্ড নির্দিষ্ট করতে পারেন। কোয়েরিতে নির্দিষ্ট করা ক্রম অনুসারেই ফলাফলগুলো সাজানো হবে। উদাহরণস্বরূপ, এই কোয়েরিতে, ফলাফলগুলো প্রথমে offer_id অনুযায়ী ঊর্ধ্বক্রমে, তারপর ইম্প্রেশনের সংখ্যা অনুযায়ী অধঃক্রমে এবং সবশেষে ক্লিকের সংখ্যা অনুযায়ী অধঃক্রমে সাজানো হবে:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY
  segments.offer_id,
  metrics.impressions DESC,
  metrics.clicks DESC

সীমা

LIMIT ক্লজটি আপনাকে ফেরত আসা ফলাফলের সংখ্যা নির্দিষ্ট করার সুযোগ দেয়। আপনি যদি শুধু একটি সারসংক্ষেপে আগ্রহী হন, তবে এটি বেশ কার্যকর।

উদাহরণস্বরূপ, নিম্নলিখিত কোয়েরির জন্য মোট ফলাফলের সংখ্যা সীমিত করতে LIMIT ব্যবহার করা যেতে পারে:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.impressions DESC
LIMIT 50