گزینشگران

انتخاب‌کننده‌ها به برنامه‌نویس کمک می‌کنند پرسمانی را بسازد که نهادهای 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()، تکرارگر را از آن دریافت کرد.

برای دریافت نکته‌ها و ترفندهایی درباره استفاده کارآمد از انتخابگر، روال‌های مطلوب را بخوانید.