المحددات

تساعد أدوات الاختيار المبرمج على إنشاء طلب البحث الذي يجلب كيانات "إعلانات Google" المطلوبة. باستخدام أدوات الاختيار، يمكن تضييق نطاق قائمة الكيانات التي تم استردادها وترتيبها. تحتوي معظم أدوات الاختيار على الطرق التالية:

withCondition()
تضيف شرطًا إلى أداة اختيار. في حال استخدام شروط متعددة، يتم ربطها معًا باستخدام AND، ما يعني أنّ أداة الاختيار لن تعرض إلا الكيانات التي تستوفي جميع الشروط المحدّدة.
withIds()
تضيف مجموعة من المعرّفات كـ شرط. سيتم ربط الشرط المستند إلى المعرّف مع جميع الشروط الأخرى باستخدام AND.
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().

يمكنك الاطّلاع على أفضل الممارسات للحصول على نصائح وحيل حول الاستخدام الفعّال لأدوات الاختيار.