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