Google বিজ্ঞাপন কোয়েরি ভাষা

রিসোর্স বা মেটাডেটা তথ্যের জন্য অনুসন্ধান

Google Ads Query Language নিম্নলিখিত ধরণের তথ্যের জন্য Google Ads API-কে কোয়েরি করতে পারে:

• GoogleAdsService Search বা SearchStream ব্যবহার করে রিসোর্স এবং তাদের সম্পর্কিত বৈশিষ্ট্য, বিভাগ এবং মেট্রিক্স: একটি GoogleAdsService কোয়েরির ফলাফল হল GoogleAdsRow ইনস্ট্যান্সের একটি তালিকা, যেখানে প্রতিটি GoogleAdsRow একটি রিসোর্স উপস্থাপন করে।

  যদি কোনও বৈশিষ্ট্য বা মেট্রিক্স অনুরোধ করা হয়, তাহলে সারিতে সেই ক্ষেত্রগুলিও অন্তর্ভুক্ত থাকে। যদি কোনও বিভাগ অনুরোধ করা হয়, তাহলে প্রতিক্রিয়াটি প্রতিটি বিভাগ-সম্পদ টিপলের জন্য একটি অতিরিক্ত সারিও দেখায়।

• GoogleAdsFieldService এ উপলব্ধ ক্ষেত্র এবং সংস্থানগুলির মেটাডেটা: এই পরিষেবাটি তাদের সামঞ্জস্যতা এবং প্রকার সম্পর্কে সুনির্দিষ্ট তথ্য সহ অনুসন্ধানযোগ্য ক্ষেত্রগুলির একটি ক্যাটালগ প্রদান করে।

  একটি GoogleAdsFieldService কোয়েরির ফলাফল হল GoogleAdsField ইনস্ট্যান্সের একটি তালিকা, যেখানে প্রতিটি GoogleAdsField অনুরোধকৃত ফিল্ড সম্পর্কে বিশদ বিবরণ থাকে।

রিসোর্স অ্যাট্রিবিউটের জন্য কোয়েরি

ক্যাম্পেইন রিসোর্সের বৈশিষ্ট্যগুলির জন্য একটি মৌলিক প্রশ্নের উদাহরণ এখানে দেওয়া হল যা ক্যাম্পেইন আইডি, নাম এবং স্ট্যাটাস কীভাবে ফেরত দিতে হয় তা ব্যাখ্যা করে:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id

এই কোয়েরিটি ক্যাম্পেইন আইডি অনুসারে অর্ডার করে। প্রতিটি ফলাফল প্রাপ্ত GoogleAdsRow একটি campaign অবজেক্টকে প্রতিনিধিত্ব করে যেখানে নির্বাচিত ক্ষেত্রগুলি ভরা থাকে, যার মধ্যে ক্যাম্পেইনটির resource_name ও অন্তর্ভুক্ত থাকে।

প্রচারাভিযানের প্রশ্নের জন্য আর কোন ক্ষেত্রগুলি উপলব্ধ তা জানতে, Campaign রেফারেন্স ডকুমেন্টেশনটি দেখুন।

মেট্রিক্সের জন্য কোয়েরি

একটি প্রদত্ত রিসোর্সের জন্য নির্বাচিত বৈশিষ্ট্যের পাশাপাশি, আপনি সম্পর্কিত মেট্রিক্সের জন্যও অনুসন্ধান করতে পারেন:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id

এই কোয়েরিটি শুধুমাত্র সেইসব প্রচারাভিযানগুলিকে ফিল্টার করে যেগুলির স্ট্যাটাস PAUSED এবং ১০০০-এর বেশি ইম্প্রেশন রয়েছে, ক্যাম্পেইন আইডি অনুসারে ক্রমানুসারে। প্রতিটি ফলাফলস্বরূপ GoogleAdsRow একটি metrics ফিল্ড থাকবে যেখানে নির্বাচিত মেট্রিক্স থাকবে।

জিজ্ঞাসাযোগ্য মেট্রিক্সের তালিকার জন্য, Metrics ডকুমেন্টেশন দেখুন।

বিভাগগুলির জন্য অনুসন্ধান

একটি প্রদত্ত সম্পদের জন্য নির্বাচিত বৈশিষ্ট্যের পাশাপাশি, আপনি সম্পর্কিত বিভাগগুলির জন্যও অনুসন্ধান করতে পারেন:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id

মেট্রিক্সের জন্য কোয়েরি করার মতো, এই কোয়েরিটি শুধুমাত্র সেইসব প্রচারণার জন্য ফিল্টার করে যেগুলোর স্ট্যাটাস PAUSED এবং ১০০০-এর বেশি ইম্প্রেশন রয়েছে। তবে, এই কোয়েরিটি তারিখ অনুসারে ডেটা ভাগ করে। এর ফলে প্রতিটি ফলাফল GoogleAdsRow একটি প্রচারণার একটি টুপল এবং তারিখের Segment প্রতিনিধিত্ব করে। Segmenting নির্বাচিত মেট্রিক্সগুলিকে বিভক্ত করে, SELECT ক্লজে প্রতিটি সেগমেন্ট অনুসারে গ্রুপ করে।

অনুসন্ধানযোগ্য অংশগুলির তালিকার জন্য, Segments ডকুমেন্টেশন দেখুন।

সম্পর্কিত সম্পদের বৈশিষ্ট্যের জন্য অনুসন্ধান

একটি নির্দিষ্ট রিসোর্সের জন্য একটি কোয়েরিতে, যদি উপলব্ধ থাকে তবে আপনি অন্যান্য সম্পর্কিত রিসোর্সের বিরুদ্ধে যোগদান করতে সক্ষম হতে পারেন। এই সম্পর্কিত রিসোর্সগুলিকে "অ্যাট্রিবিউটেড রিসোর্স" বলা হয়। আপনি আপনার কোয়েরিতে একটি অ্যাট্রিবিউট নির্বাচন করে অন্তর্নিহিতভাবে অ্যাট্রিবিউটেড রিসোর্সের বিরুদ্ধে যোগদান করতে পারেন।

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

এই কোয়েরিটি কেবল প্রচারণার বৈশিষ্ট্যগুলিই নির্বাচন করে না, বরং নির্বাচিত প্রতিটি প্রচারণা থেকে সম্পর্কিত বৈশিষ্ট্যগুলিও সংগ্রহ করে। প্রতিটি ফলাফল প্রাপ্ত GoogleAdsRow নির্বাচিত প্রচারণার বৈশিষ্ট্যগুলি, সেইসাথে নির্বাচিত বিডিং কৌশল বৈশিষ্ট্য bidding_strategy.name দ্বারা পূর্ণ একটি campaign বস্তুকে প্রতিনিধিত্ব করে।

প্রচারাভিযানের প্রশ্নের জন্য কোন কোন সম্পদ পাওয়া যায় তা জানতে, Campaign রেফারেন্স ডকুমেন্টেশন দেখুন।

কোয়েরির ফলাফলের উপর ভিত্তি করে পরিবর্তন করুন

কোনও প্রদত্ত রিসোর্সের জন্য অনুসন্ধান করার সময়, আপনি অবিলম্বে সেই ফলাফলগুলিকে অবজেক্ট হিসাবে নিতে পারেন, সেগুলিকে সংশোধন করতে পারেন এবং সেই রিসোর্সের পরিষেবাতে mutate পদ্ধতিতে ফেরত পাঠাতে পারেন। এখানে একটি নমুনা কর্মপ্রবাহ রয়েছে: 1. বর্তমানে PAUSED এবং 1000 এর বেশি ইম্প্রেশনযুক্ত সমস্ত প্রচারাভিযানের জন্য একটি কোয়েরি সম্পাদন করুন। 1. প্রতিক্রিয়াতে প্রতিটি GoogleAdsRow এর campaign ক্ষেত্র থেকে Campaign অবজেক্টটি পান। 1. প্রতিটি প্রচারাভিযানের স্থিতি PAUSED থেকে ENABLED এ পরিবর্তন করুন। 1. পরিবর্তিত প্রচারাভিযানগুলি আপডেট করার জন্য CampaignService.MutateCampaigns এ কল করুন।

ফিল্ড মেটাডেটা

GoogleAdsFieldService এ পাঠানো কোয়েরিগুলি ফিল্ড মেটাডেটা পুনরুদ্ধারের জন্য তৈরি। এই তথ্যটি কীভাবে ফিল্ডগুলিকে একসাথে একটি কোয়েরিতে ব্যবহার করা যেতে পারে তা বোঝার জন্য ব্যবহার করা যেতে পারে। যেহেতু API থেকে ডেটা পাওয়া যায় এবং এটি একটি কোয়েরি যাচাই বা তৈরি করার জন্য প্রয়োজনীয় মেটাডেটা সরবরাহ করে, তাই এটি ডেভেলপারদের প্রোগ্রাম্যাটিকভাবে এটি করার অনুমতি দেয়। মেটাডেটার জন্য এখানে একটি সাধারণ কোয়েরি দেওয়া হল:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = "<INSERT_RESOURCE_OR_FIELD>"

আপনি এই কোয়েরিতে <INSERT_RESOURCE_OR_FIELD> একটি রিসোর্স (যেমন customer অথবা campaign ) অথবা ফিল্ড (যেমন campaign.id , metrics.impressions , অথবা ad_group.id ) দিয়ে প্রতিস্থাপন করতে পারেন।

অনুসন্ধানযোগ্য ক্ষেত্রগুলির তালিকার জন্য, GoogleAdsField ডকুমেন্টেশন দেখুন।

কোড উদাহরণ

ক্লায়েন্ট লাইব্রেরিগুলিতে GoogleAdsService এ Google Ads Query Language ব্যবহারের উদাহরণ রয়েছে। বেসিক অপারেশন ফোল্ডারে GetCampaigns , GetKeywords এবং SearchForGoogleAdsFields এর মতো উদাহরণ রয়েছে।