প্রোগ্রামারকে কোয়েরি তৈরি করতে সিলেক্টর সাহায্য করে, যা অনুরোধ করা Google Ads এন্টিটি নিয়ে আসে। নির্বাচকের সাহায্যে, কেউ পুনরুদ্ধার করা এন্টিটির তালিকা সংক্ষিপ্ত করতে এবং এটি অর্ডার করতে পারেন। বেশিরভাগ সিলেক্টরে নিম্নলিখিত পদ্ধতি থাকে:
withCondition()- সিলেক্টরে শর্ত যোগ করে। একাধিক শর্ত ব্যবহার করা হলে, সেগুলি একসাথে AND-ed করা হয়, অন্য কথায়, সিলেক্টর শুধুমাত্র সেইসব এন্টিটি রিটার্ন করবে যা নির্দিষ্ট করা সব শর্ত পূরণ করে।
withIds()- শর্ত হিসেবে আইডি-এর একটি সংগ্রহ যোগ করে। আইডি-ভিত্তিক শর্ত অন্য সব শর্তের সাথে AND-ed করা হবে।
forDateRange()- প্রয়োজন হয় যখন কোনও শর্ত বা অর্ডারিং ক্লজ পরিসংখ্যান ফিল্ডকে রেফার করে, যেমন Ctr বা ইম্প্রেশন। আপনি যদি ১০০টির বেশি ইম্প্রেশন সহ সব ক্যাম্পেনের জন্য অনুরোধ করেন, তাহলে Google Ads স্ক্রিপ্টকে তারিখের রেঞ্জ জানতে হবে।
orderBy()- ফেরত দেওয়া এন্টিটির ক্রম নির্দিষ্ট করে।
withLimit()- নির্দিষ্ট ভ্যালুতে ফেরত আসা এন্টিটির সংখ্যা সীমিত করে। "গতকাল সবচেয়ে বেশি ইম্প্রেশন পাওয়া ১০টি কীওয়ার্ড"-এর মতো
তথ্য পেতে
orderBy()-এর সাথে এটি ব্যবহার করলে বিশেষভাবে উপযোগী হয়। ডিফল্ট হিসেবে, সব সিলেক্টর সীমা ৫০,০০০-এ সেট করবে। আপনি ম্যানুয়ালি সীমা উল্লেখ করে সীমা বাড়াতে পারবেন।
এইসব পদ্ধতি যেকোনও ক্রমে কল করা যেতে পারে। একটি ব্যতিক্রম হল orderBy(), যেখানে
কলের ক্রম সত্যিই গুরুত্বপূর্ণ: এই পদ্ধতিতে একাধিক কল একাধিক
অর্ডারিং ক্লজ নির্দিষ্ট করবে এবং সেগুলি ক্রমানুসারে প্রযোজ্য হবে। নিম্নলিখিত স্নিপেটটি
বিবেচনা করুন:
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
ক্লিকের সংখ্যা অনুযায়ী বড় থেকে ছোট ক্রমে ফলাফল সাজানো হবে। সমান ক্লিক ভ্যালু সহ ফলাফলগুলি Ctr অনুযায়ী ছোট থেকে বড় ক্রমে সাজানো হবে।
কোনও সিলেক্টরের পদ্ধতিতে করা কল একসাথে চেইন করা যেতে পারে। নিম্নলিখিত কোড
var campaignSelector = AdsApp.campaigns();
campaignSelector.withCondition("metrics.clicks > 10");
campaignSelector.withCondition("metrics.impressions > 1000");
campaignSelector.orderBy("metrics.impressions DESC");
campaignSelector.forDateRange("YESTERDAY");
আরও সংক্ষিপ্তভাবে আবার লেখা যেতে পারে:
var campaignSelector = AdsApp.campaigns()
.withCondition("metrics.clicks > 10")
.withCondition("metrics.impressions > 1000")
.orderBy("metrics.impressions DESC")
.forDateRange("YESTERDAY");
সিলেক্টর তৈরি হয়ে গেলে,
selector.get() কল করে
Iterator পাওয়া যাবে।
দক্ষতার সাথে সিলেক্টর ব্যবহার করার পরামর্শ ও কৌশল জানতে পেশাদার পদ্ধতি পড়ুন।