広告ルールの仕様変更

このページでは、change_specの詳細を取り上げ、実行オプションの構築方法とより高度な機能の使用方法について説明します。

change_specは、CHANGE_BUDGETおよびCHANGE_BIDといった実行型に使用され、amountlimitunittarget_fieldのパラメーターを含んでいます。

フィールド 説明

amount

必須。

予算または入札価格の変更金額を決定します。change_spec内の他のパラメーターの値は、この金額の実際の使用方法を決定します。


サポートされる値:3000-50などの数値

limit

任意。

最大または最少の予算または入札価格を指定します。例えば、予算や入札価格を増額した場合、この数値は上限として機能します。target_fieldが存在する場合、この数値によって値の下限から上限までの範囲が指定されます。


サポートされる値: 50米ドルを表す5000などの通貨、またはtarget_fieldの場合には40から60米ドルを表す[4000, 6000]などの通貨の範囲。

unit

target_fieldが存在する場合を除いて、必須。

amountの値の単位を指定します。例えば、この単位がPERCENTAGEの場合、amount-50-50%を意味します。


サポートされる値:ACCOUNT_CURRENCYまたはPERCENTAGE

target_field

任意。

予算や入札価格をターゲット値で調整するかどうかを指定します。これが存在する場合、amountはターゲットフィールドのターゲット値です。広告セットのターゲットフィールドの現在値がamountより低いか高いかに基づいて、予算や入札価格は増額または減額されます。


サポートされる値:cost_per_mobile_app_installmobile_app_purchase_roasなどのインサイトフィールド

次に示すのは、パフォーマンスが低いすべての広告セットの予算を30%削減するCHANGE_BUDGETルールの例です。パフォーマンスが低いとは、通算予算の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値に基づいて入札価格が毎日調整される別の例です。

また、10%の許容範囲枠を導入するためにcost_per_mobile_app_installの範囲フィルターを追加しました。現在の値がターゲット値にかなり近い場合、この設定によってマイナーな比例変更が行われなくなります。

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の場合、入札価格は5.0のターゲット値と現在の値との差である25%増額されます。

この制限があるため、入札価格が10.0より高くなったり2.0より低くなったりすることはありません。