انتخاب‌کننده‌ها به برنامه‌نویس کمک می‌کنند پرسمانی را بسازد که نهادهای Google Ads درخواست‌شده را واکشی می‌کند. با انتخابگرها، می‌توان فهرست نهادهای بازیابی‌شده را محدود کرد و آن را مرتب کرد. اکثر گزینشگرها روش‌های زیر را دارند:
withCondition()- شرطی را به گزینشگر اضافه می‌کند. اگر از چندین شرط استفاده شود، این شرط‌ها با «و» با هم ترکیب می‌شوند، به عبارت دیگر، انتخابگر فقط نهادهایی را برمی‌گرداند که همه شرایط مشخص‌شده را برآورده کنند.
withIds()- مجموعه‌ای از شناسه‌ها را به‌عنوان شرط اضافه می‌کند. شرط مبتنی بر شناسه با همه شرایط دیگر «و» می‌شود.
forDateRange()- وقتی لازم است که شرط یا عبارت ترتیب‌دهی به فیلد آمار ارجاع دهد، مثل نرخ کلیک‌گذری یا ظهورها. اگر همه پویش‌های با بیش‌از ۱۰۰ ظهور را درخواست کنید، جاوااسکریپت Google Ads باید محدوده تاریخ را برای بررسی بداند.
orderBy()- ترتیب نهادهای برگشتی را مشخص می‌کند.
withLimit()- تعداد نهادهای برگردانده‌شده را به مقدار مشخص‌شده محدود می‌کند. این ویژگی به‌ویژه در ترکیب با
orderBy()برای واکشی مواردی مانند «۱۰ کلیدواژه با بیشترین ظهور در دیروز» مفید است. به‌طور پیش‌فرض، همه انتخاب‌کننده‌ها حد را روی ۵۰٬۰۰۰ تنظیم می‌کنند. با مشخص کردن دستی محدودیت می‌توانید این محدودیت را افزایش دهید.
این روش‌ها را می‌توان به هر ترتیبی فراخوانی کرد. یک استثنا orderBy() است، جایی که ترتیب تماس‌ها واقعاً مهم است: تماس‌های متعدد با این روش چندین بند ترتیب را مشخص می‌کند و این بندها به ترتیب اعمال می‌شوند. تکه‌کد زیر را درنظر بگیرید:
selector = selector.forDateRange("LAST_14_DAYS")
.orderBy("metrics.clicks DESC")
.orderBy("metrics.ctr ASC");
نتایج براساس «کلیک‌ها» به‌ترتیب نزولی مرتب خواهند شد. نتایج با مقادیر کلیک برابر براساس نرخ کلیک‌گذری به‌ترتیب صعودی مرتب خواهند شد.
فراخوانی‌های روش‌های انتخابگر را می‌توان به‌صورت زنجیره‌ای به هم متصل کرد. کد زیر
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()،
تکرارگر را از آن دریافت کرد.
برای نکته‌ها و ترفندهای استفاده کارآمد از انتخابگر، روال‌های مطلوب را بخوانید.