অনুসন্ধান বিজ্ঞাপন 360 কোয়েরি ভাষা

সার্চ অ্যাডস ৩৬০ কোয়েরি ল্যাঙ্গুয়েজ আপনাকে সার্চ অ্যাডস ৩৬০ রিপোর্টিং এপিআই ব্যবহার করে রিপোর্টিং ডেটা এবং রিসোর্স মেটাডেটা পুনরুদ্ধার করার জন্য সার্চ কোয়েরি তৈরি করতে দেয়।

অনুসন্ধান পরিষেবা

আপনি Search Ads 360 Query Language ব্যবহার করে API-কে কোয়েরি করতে পারেন, যেভাবে নিচে দেওয়া হলো:

SearchAds360Service

রিসোর্স এবং তাদের সম্পর্কিত অ্যাট্রিবিউট, সেগমেন্ট ও মেট্রিক্স কোয়েরি করতে এই পরিষেবাটি ব্যবহার করুন। এর দুটি মেথড রয়েছে, Search এবং SearchStream

SearchAds360Service কোয়েরিগুলো SearchAds360Row ইনস্ট্যান্সগুলোর একটি তালিকা ফেরত দেয়:

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

আরও তথ্যের জন্য ‘অনুসন্ধান প্রতিবেদন তৈরি করুন’ দেখুন।

SearchAds360FieldService

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

SearchAds360FieldService SearchAds360Field ইনস্ট্যান্সগুলোর একটি তালিকা ফেরত দেয়:

  • প্রতিটি ফিল্ডে অনুরোধকৃত ফিল্ড সম্পর্কিত বিবরণ রয়েছে।

আরও জানতে ‘রিসোর্স মেটাডেটা পুনরুদ্ধার’ দেখুন।

মৌলিক কোয়েরির উদাহরণ

নিম্নলিখিত বিভাগগুলিতে মৌলিক কোয়েরির উদাহরণ দেওয়া হয়েছে, যেগুলো পরিবর্তন করে আপনি নিজের কোয়েরি তৈরি করতে পারেন।

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

এটি campaign রিসোর্সের অ্যাট্রিবিউটগুলোর জন্য একটি সাধারণ কোয়েরি, যা ক্যাম্পেইন আইডি, নাম এবং স্ট্যাটাস ফেরত দেয়:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • ফেরত আসা প্রতিটি SearchAds360Row একটি campaign অবজেক্টকে প্রতিনিধিত্ব করে।
  • সারিগুলো নির্বাচিত ফিল্ডগুলো (প্রদত্ত ক্যাম্পেইনের 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 স্ট্যাটাস এবং ১০০০-এর বেশি ইম্প্রেশনযুক্ত ক্যাম্পেইনগুলো ফেরত দেয়।

  • ফেরত আসা প্রতিটি SearchAds360Row একটি metrics ফিল্ড থাকে, যা নির্বাচিত মেট্রিক্স দ্বারা পূরণ করা হয়।

  • কোয়েরিটি ক্যাম্পেইন আইডি অনুসারে সাজায়।

আপনার কোয়েরিতে ব্যবহার করতে পারেন এমন অন্যান্য উপলব্ধ মেট্রিকগুলো দেখতে metrics দেখুন।

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

এটি campaign রিসোর্সের অ্যাট্রিবিউট সম্পর্কিত সেগমেন্টগুলোর জন্য একটি সাধারণ কোয়েরি:

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 স্ট্যাটাস এবং ১০০০-এর বেশি ইম্প্রেশনযুক্ত ক্যাম্পেইনগুলো ফেরত দেয়।

  • এটি তারিখ অনুসারে ডেটা ভাগ করে।

  • বিভাজনের ফলে, প্রতিটি SearchAds360Row একটি ক্যাম্পেইন এবং তারিখ বিভাজনের একটি টাপলকে প্রতিনিধিত্ব করে।

  • কোয়েরিটি ক্যাম্পেইন আইডি অনুসারে সাজায়।

আপনার কোয়েরিতে ব্যবহারযোগ্য সেগমেন্টের তালিকার জন্য segments দেখুন এবং আপনার রিপোর্ট সেগমেন্ট করার বিষয়ে আরও তথ্যের জন্য 'সেগমেন্টেশন' দেখুন।

এটি campaign রিসোর্সের উপর একটি সাধারণ কোয়েরি যা, যদি উপলব্ধ থাকে, তাহলে bidding_strategy রিসোর্সের অ্যাট্রিবিউটগুলোকে যুক্ত করে। এই ধরনের সম্পর্কিত রিসোর্স অ্যাট্রিবিউটেড রিসোর্স নামে পরিচিত।

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • কোয়েরিটি নির্বাচিত প্রতিটি ক্যাম্পেইন থেকে ক্যাম্পেইন অ্যাট্রিবিউট এবং সম্পর্কিত অ্যাট্রিবিউটগুলো নির্বাচন করে।

  • ফেরত আসা প্রতিটি SearchAds360Row একটি campaign অবজেক্টের প্রতিনিধিত্ব করে, যা নির্বাচিত ক্যাম্পেইন অ্যাট্রিবিউট এবং নির্বাচিত বিডিং স্ট্র্যাটেজি অ্যাট্রিবিউট, bidding_strategy.name দ্বারা পূর্ণ থাকে।

ক্যাম্পেইন কোয়েরির জন্য কোন অ্যাট্রিবিউটেড রিসোর্সগুলো উপলব্ধ আছে তা জানতে campaign দেখুন।

ফিল্ড মেটাডেটার জন্য কোয়েরি করুন

আপনি ফিল্ড মেটাডেটা পুনরুদ্ধার করতে SearchAds360FieldService ব্যবহার করতে পারেন।

এটি ফিল্ড মেটাডেটার জন্য একটি সাধারণ কোয়েরি:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • RESOURCE OR FIELD-কে একটি রিসোর্স (যেমন, customer বা campaign ) অথবা একটি ফিল্ড (যেমন, campaign.id , metrics.impressions বা ad_group.id ) দিয়ে প্রতিস্থাপন করুন।

ফিল্ড মেটাডেটা পুনরুদ্ধার সম্পর্কে আরও তথ্যের জন্য 'রিসোর্স মেটাডেটা পুনরুদ্ধার' দেখুন।

আরও জানুন

Search Ads 360 রিপোর্টিং API-তে কীভাবে কোয়েরি তৈরি করতে হয় সে সম্পর্কে আরও জানুন: