المحددات

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

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

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