সার্চ অ্যাডস ৩৬০ রিপোর্টিং এপিআই-এর প্রধান উপাদানগুলো হলো রিসোর্স এবং সার্ভিস । একটি রিসোর্স একটি সার্চ অ্যাডস ৩৬০ এনটিটির প্রতিনিধিত্ব করে এবং সার্চ অ্যাডস ৩৬০ এনটিটিগুলো পুনরুদ্ধার করার জন্য একটি সার্ভিস ব্যবহার করা হয়।
বস্তুর শ্রেণিবিন্যাস
একটি Search Ads 360 অ্যাকাউন্ট হলো অবজেক্টের একটি স্তরক্রম।
একটি অ্যাকাউন্টের সর্বোচ্চ স্তরের সম্পদ হলো গ্রাহক ।
প্রতিটি অ্যাকাউন্টে এক বা একাধিক সক্রিয় ক্যাম্পেইন থাকে।
প্রতিটি
Campaignএক বা একাধিক অ্যাড গ্রুপ থাকে, যা আপনার বিজ্ঞাপনগুলোকে যৌক্তিক সংগ্রহে বিভক্ত করে।প্রতিটি
AdGroupএক বা একাধিক অ্যাড গ্রুপ অ্যাড থাকে।আপনি একটি অ্যাড গ্রুপ বা ক্যাম্পেইনের সাথে এক বা একাধিক
AdGroupCriterionবাCampaignCriterionসংযুক্ত করতে পারেন। ক্রাইটেরিয়া নির্ধারণ করে দেয় যে বিজ্ঞাপনগুলো কীভাবে প্রদর্শিত হবে।- বিভিন্ন ধরণের মানদণ্ড রয়েছে, যেমন, কীওয়ার্ড, বয়সসীমা এবং অবস্থান। ক্যাম্পেইন পর্যায়ে নির্ধারিত মানদণ্ডগুলো ক্যাম্পেইনের অন্তর্ভুক্ত অন্যান্য সমস্ত রিসোর্সকে প্রভাবিত করে। এছাড়াও আপনি ক্যাম্পেইন-ব্যাপী বাজেট এবং তারিখ নির্দিষ্ট করে দিতে পারেন।
সম্পদ
রিসোর্স হলো আপনার Search Ads 360 অ্যাকাউন্টের অন্তর্ভুক্ত সত্তাগুলো। উদাহরণস্বরূপ, রিসোর্সগুলোর মধ্যে রয়েছে Customer , Campaign এবং AdGroup ।
বস্তু আইডি
Search Ads 360-এর প্রতিটি অবজেক্ট তার নিজস্ব আইডি দ্বারা চিহ্নিত করা হয়। কিছু আইডি বিশ্বব্যাপী অনন্য, অর্থাৎ সমস্ত Search Ads 360 অ্যাকাউন্ট জুড়ে অনন্য, আবার অন্যগুলো কেবল একটি সীমিত পরিসরের মধ্যে অনন্য।
| অবজেক্ট আইডি অনন্যতার পরিধি | |
|---|---|
| বাজেট আইডি | বিশ্বব্যাপী |
| ক্যাম্পেইন আইডি | বিশ্বব্যাপী |
| অ্যাডগ্রুপ আইডি | বিশ্বব্যাপী |
| বিজ্ঞাপন আইডি | বিজ্ঞাপন গোষ্ঠী প্রতিটি AdGroupId / AdId জোড়া বিশ্বব্যাপী অনন্য। |
| AdGroupCriterion ID | বিজ্ঞাপন গোষ্ঠী প্রতিটি AdGroupId / CriterionId জোড়া বিশ্বব্যাপী অনন্য। |
| প্রচারাভিযানের মানদণ্ড আইডি | প্রচারণা প্রতিটি CampaignId / CriterionId জোড়া বিশ্বব্যাপী অনন্য। |
| বিজ্ঞাপন সম্প্রসারণ | প্রচারণা প্রতিটি CampaignId / AdExtensionId জোড়া বিশ্বব্যাপী অনন্য। |
| ফিড আইডি | বিশ্বব্যাপী |
| ফিড আইটেম আইডি | বিশ্বব্যাপী |
| ফিড অ্যাট্রিবিউট আইডি | খাওয়ানো |
| ফিড ম্যাপিং আইডি | বিশ্বব্যাপী |
| লেবেল আইডি | বিশ্বব্যাপী |
| ব্যবহারকারীর তালিকা আইডি | বিশ্বব্যাপী |
আপনার Search Ads 360 অবজেক্টগুলোর জন্য লোকাল স্টোরেজ ডিজাইন করার সময় এই আইডি নিয়মগুলো সহায়ক হতে পারে।
বস্তুর প্রকারভেদ
কিছু অবজেক্ট একাধিক এনটিটি টাইপের জন্য ব্যবহার করা যেতে পারে। যদি এমন হয়, তাহলে অবজেক্টটিতে একটি type ফিল্ড থাকে যা এর বিষয়বস্তু বর্ণনা করে। উদাহরণস্বরূপ, AdGroupAd একটি টেক্সট অ্যাড, হোটেল অ্যাড বা লোকাল অ্যাডকে নির্দেশ করতে পারে। আপনি AdGroupAd.ad.type ফিল্ডের মাধ্যমে টাইপ ভ্যালুটি অ্যাক্সেস করতে পারেন। এর ভ্যালুটি AdType enum-এ রিটার্ন করা হয়।
সম্পদের নাম
প্রতিটি রিসোর্স একটি resource_name স্ট্রিং দ্বারা অনন্যভাবে চিহ্নিত হয়, যা রিসোর্সটিকে এবং এর প্যারেন্টদের সংযুক্ত করে একটি পাথ তৈরি করে।
উদাহরণস্বরূপ, ক্যাম্পেইন রিসোর্সের নামগুলোর গঠনটি হলো:
customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID
গ্রাহক আইডি 1234567 -এর Search Ads 360 অ্যাকাউন্টে আইডি 987654 সহ একটি ক্যাম্পেইনের resource_name হলো:
customers/1234567/campaigns/987654
পরিষেবা
সার্ভিসগুলোর মাধ্যমে আপনি আপনার সার্চ অ্যাডস ৩৬০ এনটিটি এবং মেটাডেটা পুনরুদ্ধার করতে পারেন। সার্ভিসের তিনটি প্রকার রয়েছে:
- অনুসন্ধান পরিষেবা
-
SearchAds360Serviceহলো সমস্ত রিসোর্স অবজেক্ট এবং পারফরম্যান্স পরিসংখ্যান পুনরুদ্ধার করার জন্য একটি একক, সমন্বিত পরিষেবা। এটি দুটি পদ্ধতি প্রদান করে:SearchএবংSearchStream। উভয় পদ্ধতির জন্যই একটি কোয়েরি প্রয়োজন, যা নির্দিষ্ট করে দেয় কোন রিসোর্স কোয়েরি করতে হবে, কোন রিসোর্স অ্যাট্রিবিউট ও পারফরম্যান্স মেট্রিক্স পুনরুদ্ধার করতে হবে, অনুরোধ ফিল্টার করার জন্য কোন প্রেডিকেট ব্যবহার করতে হবে, এবং পারফরম্যান্স পরিসংখ্যানকে আরও বিশদভাবে বিশ্লেষণ করার জন্য কোন সেগমেন্ট ব্যবহার করতে হবে। আরও তথ্যের জন্য 'সার্চ রিপোর্ট তৈরি করুন' এবং 'সার্চ অ্যাডস ৩৬০ কোয়েরি ল্যাঙ্গুয়েজ' দেখুন। - ফিল্ড সার্ভিস
-
SearchAds360FieldServiceরিসোর্স সম্পর্কিত মেটাডেটা পুনরুদ্ধার করে, যেমন, একটি রিসোর্সের জন্য উপলব্ধ অ্যাট্রিবিউট এবং এর ডেটা টাইপ। আপনিSearchAds360Serviceসার্চ মেথডগুলিতে উপলব্ধ রিসোর্স, রিসোর্স ফিল্ড, সেগমেন্টেশন কী এবং মেট্রিক্সের জন্য ক্যাটালগ অনুরোধ করতে পারেন। আরও জানতে ‘রিসোর্স মেটাডেটা পুনরুদ্ধার’ দেখুন। - সত্তা-নির্দিষ্ট পরিষেবা
এই পরিষেবাগুলিতে একটি
GETঅনুরোধ পদ্ধতি রয়েছে যা একটি একক রিসোর্স ইনস্ট্যান্স পুনরুদ্ধার করে। এটি কোনো রিসোর্সের গঠন পরীক্ষা করার জন্য উপযোগী।সত্তা-নির্দিষ্ট পরিষেবাগুলির উদাহরণ হলো:
- CustomColumnService যা অনুরোধ করা কাস্টম কলামটি সম্পূর্ণ বিবরণসহ ফেরত দেয়।