অনুসন্ধান বিজ্ঞাপন 360 রিপোর্টিং API কাঠামো

Search Ads 360 Reporting API-এর প্রাথমিক উপাদান হল সম্পদ এবং পরিষেবা । একটি সংস্থান একটি অনুসন্ধান বিজ্ঞাপন 360 সত্তাকে প্রতিনিধিত্ব করে এবং আপনি অনুসন্ধান বিজ্ঞাপন 360 সত্তা পুনরুদ্ধার করতে একটি পরিষেবা ব্যবহার করেন৷

অবজেক্ট অনুক্রম

একটি Search Ads 360 অ্যাকাউন্ট হল বস্তুর একটি অনুক্রম।

  • একটি অ্যাকাউন্টের শীর্ষ-স্তরের সংস্থান হল গ্রাহক

  • প্রতিটি অ্যাকাউন্টে এক বা একাধিক সক্রিয় প্রচারাভিযান রয়েছে।

  • প্রতিটি Campaign এক বা একাধিক বিজ্ঞাপন গোষ্ঠী থাকে যা আপনার বিজ্ঞাপনগুলিকে লজিক্যাল সংগ্রহে গোষ্ঠীবদ্ধ করে।

  • প্রতিটি AdGroup এক বা একাধিক বিজ্ঞাপন গোষ্ঠীর বিজ্ঞাপন থাকে।

  • আপনি একটি বিজ্ঞাপন গ্রুপ বা প্রচারাভিযানে এক বা একাধিক AdGroupCriterion বা CampaignCriterion সংযুক্ত করতে পারেন। বিজ্ঞাপনগুলি কীভাবে ট্রিগার করা হয় তা নির্ধারণ করে।

    • অনেক মানদণ্ডের ধরন আছে, যেমন, কীওয়ার্ড, বয়সের সীমা এবং অবস্থান। প্রচারাভিযানের স্তরে সংজ্ঞায়িত মানদণ্ড প্রচারাভিযানের মধ্যে অন্যান্য সমস্ত সংস্থানকে প্রভাবিত করে। এছাড়াও আপনি প্রচারাভিযান-ব্যাপী বাজেট এবং তারিখ নির্দিষ্ট করতে পারেন।

সম্পদ

রিসোর্স আপনার Search Ads 360 অ্যাকাউন্টে থাকা সত্তার প্রতিনিধিত্ব করে। উদাহরণ সংস্থানগুলির মধ্যে রয়েছে Customer , Campaign এবং AdGroup

অবজেক্ট আইডি

Search Ads 360-এর প্রতিটি বস্তুর নিজস্ব ID দ্বারা চিহ্নিত করা হয়। কিছু আইডি বিশ্বব্যাপী অনন্য, অর্থাৎ সমস্ত 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 সহ অনুসন্ধান বিজ্ঞাপন 360 অ্যাকাউন্টে আইডি 987654 সহ একটি প্রচারাভিযানের resource_name রয়েছে:

customers/1234567/campaigns/987654

সেবা

পরিষেবাগুলি আপনাকে আপনার অনুসন্ধান বিজ্ঞাপন 360 সত্তা এবং মেটাডেটা পুনরুদ্ধার করতে দেয়। তিন ধরনের পরিষেবা আছে:

সার্চ সার্ভিস
SearchAds360Service হল সমস্ত রিসোর্স অবজেক্ট এবং কর্মক্ষমতা পরিসংখ্যান পুনরুদ্ধারের জন্য একক, একীভূত পরিষেবা। এটি দুটি পদ্ধতি প্রদান করে: Search এবং SearchStream । উভয় পদ্ধতির জন্য একটি ক্যোয়ারী প্রয়োজন যা কোয়েরির জন্য রিসোর্স, পুনরুদ্ধার করার জন্য রিসোর্স অ্যাট্রিবিউট এবং পারফরম্যান্স মেট্রিক্স, রিকোয়েস্ট ফিল্টার করার জন্য ব্যবহার করার পূর্বাভাস এবং পারফরম্যান্স পরিসংখ্যানকে আরও ভাঙতে ব্যবহার করার জন্য সেগমেন্টগুলি নির্দিষ্ট করে। আরও তথ্যের জন্য অনুসন্ধান প্রতিবেদন এবং অনুসন্ধান বিজ্ঞাপন 360 ক্যোয়ারী ভাষা তৈরি করুন দেখুন।
ফিল্ড সার্ভিস
SearchAds360FieldService রিসোর্স সম্পর্কে মেটাডেটা পুনরুদ্ধার করে, যেমন, একটি রিসোর্সের জন্য উপলব্ধ বৈশিষ্ট্য এবং এর ডেটা টাইপ। আপনি SearchAds360Service অনুসন্ধান পদ্ধতিতে উপলব্ধ সম্পদ, সম্পদ ক্ষেত্র, বিভাজন কী এবং মেট্রিক্সের জন্য ক্যাটালগ অনুরোধ করতে পারেন। আরও জানতে সম্পদ মেটাডেটা পুনরুদ্ধার দেখুন।
সত্তা-নির্দিষ্ট পরিষেবা

এই পরিষেবাগুলি একটি GET অনুরোধ পদ্ধতি প্রদান করে যা একটি একক সংস্থান উদাহরণ পুনরুদ্ধার করে। এটি একটি সম্পদের গঠন পরীক্ষা করার জন্য দরকারী।

সত্তা-নির্দিষ্ট পরিষেবার উদাহরণগুলির মধ্যে রয়েছে:

  • CustomColumnService যা অনুরোধ করা কাস্টম কলাম সম্পূর্ণ বিশদভাবে প্রদান করে।