广告规则变更规范

本页面将更详细地讨论 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`，`-50` 的 `amount` 表示 `-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

以下是第二个示例。其中，竞价根据广告组 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 以下。