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