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

Google Ads Query Language এর জন্য Google Ads API-কে জিজ্ঞাসা করতে পারে

সম্পদ এবং তাদের সম্পর্কিত বৈশিষ্ট্য, বিভাগ, এবং মেট্রিক্স ব্যবহার করে

GoogleAdsService অনুসন্ধান বা অনুসন্ধান স্ট্রীম

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

উপলব্ধ ক্ষেত্র এবং সম্পদ সম্পর্কে মেটাডেটা

GoogleAdsFieldService

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

একটি GoogleAdsFieldService ক্যোয়ারী থেকে পাওয়া ফলাফল হল GoogleAdsField দৃষ্টান্তগুলির একটি তালিকা, প্রতিটি GoogleAdsField এ অনুরোধ করা ক্ষেত্র সম্পর্কে বিশদ বিবরণ রয়েছে৷

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

নীচে প্রচারাভিযান সংস্থানের বৈশিষ্ট্যগুলির জন্য একটি প্রাথমিক প্রশ্ন রয়েছে, প্রচারাভিযানের আইডি, নাম এবং স্থিতি কীভাবে ফেরানো যায় তা ব্যাখ্যা করে:

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

এই ক্যোয়ারী প্রচারাভিযান আইডি দ্বারা আদেশ. প্রতিটি ফলস্বরূপ GoogleAdsRow নির্বাচিত ক্ষেত্রগুলি (সেই প্রদত্ত প্রচারের resource_name সহ) একটি campaign বস্তুর প্রতিনিধিত্ব করবে।

প্রচারাভিযানের প্রশ্নের জন্য অন্য কোন ক্ষেত্র পাওয়া যায় তা জানতে, 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 এবং 1000 টির বেশি ইমপ্রেশন হয়েছে, প্রচারাভিযান আইডি দ্বারা অর্ডার করার সময়৷ প্রতিটি ফলস্বরূপ 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 আছে এবং 1000-এর বেশি ইমপ্রেশন আছে; যাইহোক, এই ক্যোয়ারী তারিখ অনুসারে ডেটা সেগমেন্ট করে। এটি প্রতিটি ফলাফলে GoogleAdsRow একটি প্রচারাভিযান এবং তারিখ Segment একটি অংশকে প্রতিনিধিত্ব করে। এটা মনে রাখা গুরুত্বপূর্ণ যে বিভাগকরণ নির্বাচিত মেট্রিক্সকে বিভক্ত করে, SELECT ক্লজে প্রতিটি সেগমেন্ট দ্বারা গোষ্ঠীবদ্ধ করে।

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

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

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

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

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

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

ক্যোয়ারী ফলাফলের উপর ভিত্তি করে মিউটটিং

একটি প্রদত্ত সংস্থানের জন্য অনুসন্ধান করার সময়, আপনি অবিলম্বে সেই প্রত্যাবর্তিত ফলাফলগুলিকে অবজেক্ট হিসাবে নিতে পারেন, সেগুলিকে সংশোধন করতে পারেন এবং সেই সংস্থানের পরিষেবাতে মিউটেট পদ্ধতিতে ফেরত পাঠাতে পারেন৷ নীচে একটি নমুনা কর্মপ্রবাহ আছে:

1. বর্তমানে PAUSED এবং 1000-এর বেশি ইমপ্রেশন আছে এমন সমস্ত প্রচারাভিযানের জন্য একটি ক্যোয়ারী চালান৷
2. প্রতিক্রিয়ায় প্রতিটি GoogleAdsRow এর campaign ক্ষেত্র থেকে Campaign বস্তু পান।
3. প্রতিটি প্রচারাভিযানের স্থিতি ENABLED থেকে PAUSED এ পরিবর্তন করুন।
4. তাদের আপডেট করতে পরিবর্তিত প্রচারাভিযানের সাথে 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 ) দিয়ে।

মূল পয়েন্ট: মনে রাখবেন যে এই ক্যোয়ারীতে কোন FROM ক্লজ নেই।

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

কোড উদাহরণ

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