تساعد أدوات الاختيار المبرمِج في إنشاء طلب البحث الذي يُجلب عناصر "إعلانات Google" المطلوبة. باستخدام المحدّدات، يمكن تضييق نطاق قائمة الكيانات التي تم استرجاعها وترتيبها. تتضمّن معظم أدوات الاختيار ال methods التالية:
withCondition()- تُضيف شرطًا إلى أداة اختيار. في حال استخدام شروط متعدّدة، يتم ربطها باستخدام "و"، بعبارة أخرى، لن يعرض الاختيار سوى الكيانات التي تستوفي جميع الشروط المحدّدة.
withIds()- تُضيف مجموعة من الأرقام التعريفية كأحد الشروط. سيتم ربط الشرط المستنِد إلى رقم التعريف بالعلاقة "و" مع جميع الشروط الأخرى.
forDateRange()- يكون مطلوبًا عندما تشير عبارة شرط أو ترتيب إلى حقل الإحصاءات، مثل نسبة النقر إلى الظهور أو مرّات الظهور. إذا طلبت جميع الحملات التي حقّقت أكثر من 100 مرّة ظهور، ستحتاج نصوص "إعلانات Google" البرمجية إلى معرفة النطاق الزمني المطلوب النظر فيه.
orderBy()- يحدد هذا الإعداد ترتيب الكيانات التي يتم عرضها.
withLimit()- تفرض حدًا أقصى لعدد الكيانات التي يتم عرضها. وهي مفيدة بشكلٍ خاص مع
orderBy()لاسترداد عناصر مثل "10 كلمات رئيسية سجّلت أكبر عدد من مرّات الظهور بالأمس". بشكلٍ تلقائي، ستحدّد جميع أدوات الاختيار الحدّ الأقصى على 50,000. يمكنك زيادة الحدّ الأقصى من خلال تحديد حدّ يدويًا.
ويمكن استدعاء هذه الطرق بأي ترتيب. يُعدّ الخطأ 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().
اقرأ أفضل الممارسات للحصول على نصائح حول الاستخدام الفعال لأداة الاختيار.