تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

المحددات

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

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()

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