廣告規則變更規格

本頁面更詳細地討論 change_spec,特別是如何建構執行選項,以及如何使用更進階的功能。

change_spec 用於 CHANGE_BUDGETCHANGE_BID 之類的執行類型,並包含以下參數:amountlimitunittarget_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_CURRENCYPERCENTAGE

target_field

選用項目。

指定是否依目標值調整預算或出價。如果此參數存在,則 amount 為目標欄位的目標值。根據目標欄位的廣告組合現行值為低於或高於 amount,預算或出價會按比例增加或減少。


支援的值:「洞察報告」欄位,例如 cost_per_mobile_app_installmobile_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

以下是另一個範例,其中出價會根據廣告組合 123 的目標 cost_per_mobile_app_install 值每天調整。

我們還為 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