مواصفات تغيير قواعد الإعلان

تناقش هذه الصفحة change_spec بمزيد من التفاصيل، وتحديدًا حول كيفية إنشاء خيار التنفيذ وكيفية استخدام الميزات الأكثر تقدمًا.

يتم استخدام change_spec لأنواع التنفيذ مثل CHANGE_BUDGET وCHANGE_BID، وتحتوي على المعلمات التالية: amount وlimit وunit وtarget_field.

الحقل الوصف

amount

مطلوب.

يحدد المبلغ لتغيير الميزانية أو عرض الأسعار. تحدد قيم المعلمات الأخرى في change_spec كيفية استخدام هذا المبلغ بالضبط.


القيم المدعومة: قيمة رقمية، مثل 3000 أو -50

limit

اختياري.

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


القيم المدعومة: العملة، مثل 5000 لتمثل 50 دولارًا أمريكيًا، أو بالنسبة إلى target_field، نطاق من العملات مثل [4000, 6000] لتمثل 40 إلى 60 دولارًا أمريكيًا.

unit

مطلوب، ما لم يكن target_field موجودًا.

يحدد وحدة القيمة amount. على سبيل المثال، إذا كانت الوحدة PERCENTAGE، فإن amount من -50 تعني -50%.


القيم المدعومة:ACCOUNT_CURRENCY أو PERCENTAGE

target_field

اختياري.

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


القيم المدعومة: حقل رؤى، مثل cost_per_mobile_app_install أو mobile_app_purchase_roas

أمثلة

فيما يلي مثال على قاعدة CHANGE_BUDGET التي تخفض الميزانيات بنسبة 30% لكل المجموعات الإعلانية ذات الأداء المنخفض، حيث نحدد الأداء المنخفض بأنه مستقر على مدى فترة عمل frequency. تعمل هذه القاعدة فقط في منتصف الليل يومي الثلاثاء والجمعة.

curl \
-F 'name=Test Change Budget Rule' \
-F 'schedule_spec={
     "schedule_type": "CUSTOM",
     "schedule": [
       {
          "start_minute": 0,
         "days": [2, 5]
       }
     ]
   }' \
-F 'evaluation_spec={
     "evaluation_type": "SCHEDULE",
     "filters": [
       {
         "field": "entity_type",
         "value": "ADSET",
         "operator": "EQUAL"
       },
       {
         "field": "time_preset",
         "value": "LIFETIME",
         "operator": "EQUAL"
       },
       {
         "field": "impressions",
         "value": 8000,
         "operator": "GREATER_THAN"
       },
       {
         "field": "frequency",
         "value": 5.0,
         "operator": "GREATER_THAN"
       }
     ]
   }' \
-F 'execution_spec={
     "execution_type": "CHANGE_BUDGET",
     "execution_options": [
       {
         "field": "change_spec",
         "value": {
           "amount": -30,
           "unit": "PERCENTAGE"
         },
         "operator": "EQUAL"
       },
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

فيما يلي مثال آخر، حيث يتم قياس عرض الأسعار يوميًا استنادًا إلى قيمة cost_per_mobile_app_install المستهدفة للمجموعة الإعلانية 123.

كما نضيف فلتر النطاق بالنسبة إلى cost_per_mobile_app_install لتوفير فترة سماح 10%. ومن خلال ذلك، لا يتم إجراء تغييرات نسبية طفيفة، إذا كانت القيمة الحالية قريبة بدرجة كافية من القيمة المستهدفة.

curl \
-F 'name=Test Change Bid Rule' \
-F 'schedule_spec={
     "schedule_type": "DAILY"
   }' \
-F 'evaluation_spec={
     "evaluation_type": "SCHEDULE",
     "filters": [
       {
         "field": "id",
         "value": [123],
         "operator": "IN"
       },
       {
         "field": "time_preset",
         "value": "LIFETIME",
         "operator": "EQUAL"
       },
       {
         "field": "mobile_app_install",
         "value": 100,
         "operator": "GREATER_THAN"
       },
       {
         "field": "cost_per_mobile_app_install",
         "value": [4.5, 5.5],
         "operator": "NOT_IN_RANGE"
       }
     ]
   }' \
-F 'execution_spec={
     "execution_type": "CHANGE_BID",
     "execution_options": [
       {
         "field": "change_spec",
         "value": {
           "amount": 5.0,
           "limit": [2.0, 10.0],
           "target_field": "cost_per_mobile_app_install"
         },
         "operator": "EQUAL"
       },
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

على سبيل المثال، إذا كانت القيمة الحالية 4.0، فستتم زيادة عرض الأسعار بنسبة 25%، حيث إن ذلك هو الفرق النسبي بين القيمة المستهدفة من 5.0 والقيمة الحالية.

يحافظ الحد على عرض الأسعار من الزيادة أكثر من 10.0 أو الانخفاض أقل من 2.0.