일정 기반 규칙

정해진 간격으로 evaluation_spec 기준을 충족하는지 확인하며 광고 상태를 모니터링합니다. 일정 기반 규칙에는 추가적인 schedule_spec이 필요합니다.

curl \
-F 'name=Rule 1' \
-F 'evaluation_spec={
    ...
   }' \
-F 'execution_spec={
    ...
   }' \
-F 'schedule_spec={
     "schedule_type": "DAILY"
   }' \

-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

일정 사양

규칙의 schedule_spec에 따라 실행 빈도가 결정됩니다. 이 간격은 schedule_type 필드로 표시됩니다.

schedule_type이 CUSTOM일 경우 맞춤 일정 리스트 또는 규칙을 실행해야 할 시간도 지정해야 합니다.

schedule 리스트에서 각 개별 사양은 다음과 같은 필드의 조합으로 구성할 수 있습니다. 요구 사항이 있다면 각 항목에 start_minute 또는 days 중 하나 이상이 존재해야 한다는 것입니다.

CUSTOM 일정 유형을 사용하는 방법에 대한 자세한 내용은 고급 일정 관리를 참조하세요.

evaluation_spec의 예시는 다음과 같습니다. 이 규칙은 ID의 초기 리스트에서 최근 7일 동안 노출이 10000회를 초과한 모든 개체에 적용됩니다. 이 경우 entity_type 필터가 필요하지 않습니다. 프리픽스 없이 id 필터를 사용하여 초기 개체의 정적 리스트를 정의했기 때문입니다.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
      "evaluation_type" : "SCHEDULE",
      "filters" : [
       {
         "field": "time_preset",
         "value": "LAST_7_DAYS",
         "operator": "EQUAL"
       },
       {
         "field": "effective_status",
         "value": ["ACTIVE"],
         "operator": "IN"
       },
       {
         "field": "id",
         "value": [101, 102, 103],
         "operator": "IN"
       },
       {
         "field": "impressions",
         "value": 10000,
         "operator": "GREATER_THAN"
       }
     ]
   }' \
-F 'execution_spec={
    ...
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

또 다른 예시는 다음과 같습니다. 이 규칙은 ID가 101, 102, 103인 광고 캠페인에서 총예산만 사용하고 48시간 이내에 생성된 모든 광고 세트에 적용됩니다. 이 경우에는 time_preset 필터가 필요하지 않습니다. 인사이트 필터가 없기 때문입니다.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
      "evaluation_type" : "SCHEDULE",
      "filters" : [
       {
         "field": "entity_type",
         "value": "ADSET",
         "operator": "EQUAL"
       },
       {
         "field": "campaign.id",
         "value": [101, 102, 103],
         "operator": "IN"
       },
       {
         "field": "budget_reset_period",
         "value": ["LIFETIME"],
         "operator": "IN"
       },
       {
         "field": "hours_since_creation",
         "value": 48,
         "operator": "LESS_THAN"
       },
     ]
   }' \
-F 'execution_spec={
    ...
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

execution_spec의 예시는 다음과 같습니다. 이 규칙은 모든 매칭되는 개체 예산을 10% 인상하며, 최대 실행 한도는 5회입니다. 매칭 가능성이 있는 모든 개체에 대해 최대 5번까지 개별적으로 예산을 10% 인상할 수 있다는 것을 의미합니다.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
    ...
   }' \
-F 'execution_spec={
     "execution_type": "CHANGE_BUDGET",
     "execution_options": [
       {
         "field": "change_spec",
         "value": {
           "amount": 10,
           "unit": "PERCENTAGE"
         },
         "operator": "EQUAL"
       },
       {
         "field": "execution_count_limit",
         "value": 5,
         "operator": "EQUAL"
       }
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library

또 다른 예시는 다음과 같습니다. 이 규칙은 모든 매칭되는 개체를 일시 정지하고 사용자 리스트에 이메일을 보냅니다.

curl \
-F 'name=Rule 1' \
-F 'schedule_spec={
    ...
   }' \
-F 'evaluation_spec={
    ...
   }' \
-F 'execution_spec={
     "execution_type": "PAUSE",
     "execution_options": [
       {
         "field": "user_ids",
         "value": [1001, 1002],
         "operator": "EQUAL"
       }
     ]
   }' \
-F "access_token=<ACCESS_TOKEN>" \
https://graph.facebook.com/<VERSION>/<AD_ACCOUNT_ID>/adrules_library