مواصفات التقييم

الغرض الرئيسي من evaluation_spec لقاعدة ما هو تحديد الكائنات التي ينبغي أن تنفذ إجراءات القاعدة على أساسها. يحدد evaluation_type نوع طريقة التقييم ولديه الخيارات التالية:

تحتوي evaluation_spec على مصفوفة filters التي تسمح لك بتضييق قائمة الكائنات المطابقة أكثر. على سبيل المثال، يمكنك إنشاء فلاتر على أدوات قياس البيانات الوصفية والرؤى للإعلانات والمجموعة الإعلانية والحملة الإعلانية. يتم تقييم جميع الفلاتر معًا باستخدام المشغل AND.

تحتوي مصفوفة filters على قائمة بكائنات الفلتر. هذه الكائنات عبارة عن قواميس تحتوي على مفاتيح field وvalue وoperator:

يحتوي كل فلتر على قائمة بالمشغلين المنطقيين المدعومين. فيما يلي المشغلين المنطقيين المدعومين في القواعد SCHEDULE وTRIGGER:

يتطلب evaluation_spectrigger لنوع التقييم TRIGGER. يحتوي المشغل على نوع ومواصفات فلتر أساسية. يمكن أن تكون مواصفات الفلتر field وvalue وoperator.

يحدد المشغل ديناميكيًا ما إذا كان ينبغي علينا تقييم قاعدة ما أم لا، ويمكنك الحصول على قاعدة واحدة فقط. راجع القواعد التي تستند إلى التشغيل لمزيد من المعلومات.

نحدد أدناه بعض الفلاتر الخاصة والمجموعات العامة من الفلاتر التي يمكنك استخدامها.

الفلاتر الخاصة

time_preset

يحدد فلتر time_preset الفترة الزمنية التي نجمع خلالها أدوات قياس الرؤى. حاليًا، نسمح بـ time_preset واحد فقط. وينطبق على جميع فلاتر الإحصائيات في القاعدة، بما في ذلك الفلاتر المستخدمة في التشغيل، إن وجدت.

المشغل الوحيد المدعوم لـ time_preset هو EQUAL، وهو مطلوب طالما يوجد أي فلتر للرؤى أو مشغِل. لا تدعم القواعد التي تستند إلى التشغيل إلّا التعيينات المسبقة للوقت التي تتضمن TODAY لأنها تُجري تقييمًا في الوقت الفعلي.

يمكن أن تتصرف التعيينات المسبقة للوقت الخاصة بالقواعد بشكل مختلف عن الواجهات الأخرى. بعض من التعيينات المسبقة للوقت هنا تتضمن بيانات اليوم. وذلك لأن بيانات اليوم مهمة جدًا للقواعد التي يتم تشغيلها بشكل متكرر أكثر من مجرد التشغيل اليومي. بالنسبة للواجهات الأخرى، لا تتضمن القيمة المُعيّنة مسبقًا من LAST_N_DAYS بيانات اليوم بشكل عام. شاهد الأوصاف أدناه لمزيد من التفاصيل.

{
  "field": "time_preset",
  "value": "TODAY",
  "operator": "EQUAL"
}

attribution_window

يحدد الفلتر attribution_window فترة المراجعة التي يتم خلالها تجميع أدوات قياس الرؤى. لمزيد من المعلومات، راجع وثائق الرؤى على فترات الإسناد.

حاليًا، نسمح بـ attribution_window واحدة فقط، وتنطبق على جميع فلاتر الإحصائيات في القاعدة. المشغل الوحيد المدعوم لـ attribution_window هو EQUAL، وهو مدعوم فقط بالقواعد المستندة إلى الجدولة.

الـ value المسموح بها فقط لـ attribution_window هي ACCOUNT_DEFAULT، سواء كانت محددة أم غير محددة.

{
  "field": "attribution_window",
  "value": "ACCOUNT_DEFAULT",
  "operator": "EQUAL"
}

فلاتر البيانات الوصفية

باستخدام فلاتر البيانات الوصفية، يمكنك فلترة الكائنات استنادًا إلى الحالة الحالية لحقول البيانات الوصفية. ويدعم ذلك أيضًا الفلاتر متعددة المستويات، مما يعني أنه يمكنك استخدام البادئات لتطبيق فلتر بيانات وصفية على أصل الكائن أو جده. وهذا لا يؤثر على الفلاتر الأخرى. ولا تزال فلاتر الرؤى تنطبق على الكائن الطبيعي.

على سبيل المثال، إذا كنت تريد قاعدة تنطبق على مجموعات إعلانية لحملات إعلانية هدفها WEBSITE_CLICKS، يمكنك تضمين فلترين:

 "filters" : [
  {
    "field": "entity_type",
    "value": "ADSET",
    "operator": "EQUAL",
  },
  {
    "field": "campaign.objective",
    "value": "WEBSITE_CLICKS",
    "operator": "EQUAL"
  }
]

فلاتر البيانات الوصفية مدعومة بالقواعد التي تستند إلى التشغيل والتي تستند إلى الجدولة

فلاتر البيانات الوصفية مدعومة فقط بالقواعد التي تستند إلى الجدولة

entity_type وid

لكل قاعدة من قواعد نوع التقييم SCHEDULE أو TRIGGER، يجب أن تحدد إما الفلتر entity_type أو id.

عندما تحدد فلتر entity_type، فإنك تحدد مستوى الكائن الديناميكي لتطبيق القاعدة عليه. على سبيل المثال، إذا كان entity_type هو AD، فهذه القاعدة تقيّم تلقائيًا كل إعلان جديد تمت إضافته إلى الحساب الإعلاني. ويحدث ذلك بغض النظر عن وقت إنشاء القاعدة. من خلال تحديد فلتر id، تنطبق القاعدة فقط على قائمة ثابتة من الكائنات.

عندما تحدد فلتر id بدون بادئة، نقوم تلقائيًا بحساب مستوى الكائن الذي نطبق عليه القاعدة. على سبيل المثال، إذا كنت تريد تطبيق قاعدة على الإعلانات [123, 456]، فأنت تحتاج فقط إلى id حقل فلتر واحد والقيمة [123, 456] والمشغل IN. في هذه الحالة، لن يكون entity_type مطلوبًا، لأنك قدمت قائمة أولية ثابتة من الكائنات، ويمكننا حساب مستوى الكائن من تلك الكائنات.

يمكنك استخدام entity_type وid بالتزامن مع الفلترة متعددة المستويات. على سبيل المثال، إذا كنت تريد قاعدة تنطبق على جميع الإعلانات ضِمن بعض المجموعات الإعلانية المحددة، يمكنك الحصول على فلتر entity_type لـ AD وفلتر adset.id مع المجموعات الإعلانية المحددة.

افتراضيًا، إذا لم تحدد فلتر effective_status، فإننا نضيف فلتر effective_status ضمنيًا عند تقييم القاعدة.

بالنسبة لجميع أنواع عمليات التنفيذ التي تعمل على الكائنات النشطة، يحتوي هذا الفلتر الافتراضي على مشغل IN وقيمة ['ACTIVE', 'PENDING_REVIEW']. وهذا يعني أن القاعدة تقيّم فقط الكائنات التي لديها عرضًا نشطًا أو سيكون لها عرضًا نشطًا. بالنسبة لأنواع عمليات التنفيذ التي لا تعمل على الكائنات النشطة (UNPAUSE)، نضيف هذا الفلتر مع مشغل NOT_IN وقيمة ['DELETED', 'ARCHIVED']. الفلتر الافتراضي هو تحسين داخلي لأنواع عمليات التنفيذ لدينا.

فلاتر الرؤى

نعمل على تقييم فلاتر الرؤى مقابل القيم الحالية التي يتم إرجاعها من واجهة API الرؤى لـ time_preset مُحدد. وتنطبق هذه الفلاتر مباشرة على قائمة الكائنات أو مستواها، ولا تدعم الفلترة متعدد المستويات. تدعم جميع فلاتر الرؤى المشغلين التاليين: GREATER_THAN، LESS_THAN، EQUAL، IN_RANGE، NOT_IN_RANGE.

للاطلاع على وصف لكل من الحقول أدناه، راجع مستندات واجهة API الرؤى. كل هذه الفلاتر مدعومة بالقواعد المستندة إلى الجدولة.

فيما يلي قائمة بفلاتر الرؤى وما إذا كانت مدعومة بالقواعد التي تستند إلى التشغيل أم لا:

فلاتر متقدمة

يمكنك تخصيص واشتقاق الحقول المتقدمة استنادًا إلى فلاتر الرؤى وفلاتر البيانات الوصفية أعلاه. لمزيد من المعلومات، راجع الفلاتر المتقدمة لمواصفات التقييم.

تدعم الفلاتر المتقدمة المشغلين التاليين: GREATER_THAN، LESS_THAN، EQUAL، IN_RANGE، NOT_IN_RANGE. وهي مدعومة فقط بالقواعد المستندة إلى الجدولة.

بالنسبة لبعض الفلاتر المتقدمة الأكثر استخدامًا، ندعم اسمًا مستعارًا كفلتر: