광고 규칙 변경 사양

이 페이지에서는 change_spec, 그중에서도 특히 실행 옵션을 구성하고 보다 고급인 기능을 사용하는 방법에 대해 자세히 설명합니다.

change_spec은 실행 유형(예: CHANGE_BUDGETCHANGE_BID)에 사용되고 amount, limit, unit, target_field 매개변수를 포함합니다.

필드 설명

amount

필수 항목.

예산 또는 입찰가를 변경할 금액을 결정합니다. change_spec의 다른 매개변수 값은 이 금액을 사용하는 방법을 정확히 결정합니다.


지원되는 값: 숫자 값(예: 3000 또는 -50)

limit

선택 사항.

최대 또는 최소 예산이나 입찰가를 지정합니다. 예를 들어 예산이나 입찰가를 늘리는 경우 이 숫자는 상한 역할을 합니다. target_field가 있을 경우, 하한 값에서 상한 값 사이의 범위를 지정합니다.


지원되는 값: $50 USD를 나타내는 통화(예: 5000) 또는 target_field의 경우 $40~60 USD를 나타내는 통화 범위(예: [4000, 6000]).

unit

target_field가 있는 경우를 제외하고는 필수 항목입니다.

amount 값의 단위를 지정합니다. 예를 들어 단위가 PERCENTAGE일 경우 -50amount-50%를 의미합니다.


지원되는 값:ACCOUNT_CURRENCY 또는 PERCENTAGE

target_field

선택 사항.

목표 값으로 예산 또는 입찰가를 조정할지 여부를 지정합니다. 이 필드가 있을 경우, amount는 타겟 필드의 목표 값입니다. 대상 필드의 광고 세트 현재 값이 amount보다 낮거나 높은지 여부에 따라 예산이나 입찰가를 비례적으로 높이거나 낮춥니다.


지원되는 값: 인사이트 필드(예: cost_per_mobile_app_install 또는 mobile_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이면 입찰가가 25% 증가합니다. 이것이 5.0의 목표 값과 현재 값 사이의 비례적 차이이기 때문입니다.

이 제한으로 인해 입찰가는 10.0 위로 상승하지 않고 2.0 아래로 하락하지 않습니다.