القواعد القائمة على الجدولة

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

curl \
-F 'name=Rule 1' \
-F 'evaluation_spec={
    ...
   }' \
-F 'execution_spec={
    ...
   }' \
-F 'schedule_spec={
     "schedule_type": "DAILY"
   }' \

-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

مواصفات الجدولة

تحدد schedule_spec للقاعدة رغبتك في مدى تشغيلها. ونشير إلى هذه الفترة الزمنية في الحقل schedule_type.

إذا كان schedule_type هو CUSTOM، فعليك أيضًا تحديد قائمة الجداول الزمنية المخصصة أو الأوقات التي يجب فيها تشغيل القاعدة.

في قائمة schedule، يمكن أن تتكون كل مواصفة فردية من مجموعة الحقول التالية. ويكون المتطلب الوحيد هو أن يكون هناك على الأقل start_minute أو days في كل إدخال.

لمزيد من المعلومات حول كيفية استخدام أنواع الجدولة CUSTOM، راجع الجدولة المتقدمة.

فيما يلي مثال على evaluation_spec. يتم تطبيق هذه القاعدة على كل الكائنات في القائمة الأولية للمعرفات التي كانت لديها أكثر من 10000 مرة ظهور إعلان في آخر 7 أيام. في هذه الحالة، لا نحتاج إلى الفلتر entity_type، حيث إننا حددنا قائمة ثابتة للكائنات الأولية باستخدام فلتر id بدون بادئة.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
      "evaluation_type" : "SCHEDULE",
      "filters" : [
       {
         "field": "time_preset",
         "value": "LAST_7_DAYS",
         "operator": "EQUAL"
       },
       {
         "field": "effective_status",
         "value": ["ACTIVE"],
         "operator": "IN"
       },
       {
         "field": "id",
         "value": [101, 102, 103],
         "operator": "IN"
       },
       {
         "field": "impressions",
         "value": 10000,
         "operator": "GREATER_THAN"
       }
     ]
   }' \
-F 'execution_spec={
    ...
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

فيما يلي مثال آخر. يتم تطبيق هذه القاعدة على كل المجموعات الإعلانية ضمن الحملات الإعلانية بالمعرف 101, 102, 103 الذي يستخدم ميزانيات الحملة كلها فقط وتم إنشاؤه لأقل من 48 ساعة. في هذه الحالة، لا نحتاج إلى الفلتر time_preset، حيث إنه لا توجد أي فلاتر رؤى.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
      "evaluation_type" : "SCHEDULE",
      "filters" : [
       {
         "field": "entity_type",
         "value": "ADSET",
         "operator": "EQUAL"
       },
       {
         "field": "campaign.id",
         "value": [101, 102, 103],
         "operator": "IN"
       },
       {
         "field": "budget_reset_period",
         "value": ["LIFETIME"],
         "operator": "IN"
       },
       {
         "field": "hours_since_creation",
         "value": 48,
         "operator": "LESS_THAN"
       },
     ]
   }' \
-F 'execution_spec={
    ...
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

فيما يلي مثال على execution_spec. تعمل هذه القاعدة على زيادة ميزانية كل الكائنات المطابقة بنسبة 10%، مع حد أقصى للتنفيذ بمقدار 5 مرات. وهذا يعني أنه لكل كائن يمكن مطابقته، يمكن أن تكون له زيادة بنسبة 10% فقط في الميزانية وعلى الأكثر خمس مرات.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
    ...
   }' \
-F 'execution_spec={
     "execution_type": "CHANGE_BUDGET",
     "execution_options": [
       {
         "field": "change_spec",
         "value": {
           "amount": 10,
           "unit": "PERCENTAGE"
         },
         "operator": "EQUAL"
       },
       {
         "field": "execution_count_limit",
         "value": 5,
         "operator": "EQUAL"
       }
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

فيما يلي مثال آخر. تعمل هذه القاعدة على إيقاف كل الكائنات المطابقة مؤقتًا وترسل رسالة بريد إلكتروني إلى قائمة المستخدمين.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
    ...
   }' \
-F 'execution_spec={
     "execution_type": "PAUSE",
     "execution_options": [
       {
         "field": "user_ids",
         "value": [1001, 1002],
         "operator": "EQUAL"
       }
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library