평가 사양

규칙 evaluation_spec의 주된 목적은 규칙이 조치를 실행해야 하는 대상 개체를 결정하는 것입니다. evaluation_type은 평가 방법의 유형을 결정하며 다음과 같은 옵션을 갖습니다.

평가 유형	설명
`SCHEDULE`	일정 기반 규칙 용도
`TRIGGER`	트리거 기반 규칙 용도

evaluation_spec에는 filters 배열이 포함되는데, 이를 통해 매칭된 개체의 리스트 범위를 더욱 좁힐 수 있습니다. 예를 들어 광고, 광고 세트 및 광고 캠페인 메타데이터와 인사이트 지표에 대한 필터를 생성할 수 있습니다. 모든 필터는 AND 연산자를 사용하여 함께 평가됩니다.

filters 배열에는 필터 개체의 리스트가 포함됩니다. 이러한 개체들은 다음과 같이 field, value 및 operator 키가 포함된 사전입니다.

필터 개체 키 설명

필터 개체 키	설명
`field`	필수 항목. 필터 필드(예: 인사이트 데이터 또는 메타데이터)
`value`	필수 항목. 필드의 정적 필터 값
`operator`	필수 항목. 필드의 논리적 연산자

field

필수 항목.

필터 필드(예: 인사이트 데이터 또는 메타데이터)

value

필수 항목.

필드의 정적 필터 값

operator

필수 항목.

필드의 논리적 연산자

각 필터에는 지원되는 논리적 연산자의 리스트가 있습니다. SCHEDULE 및 TRIGGER 규칙에서 지원되는 논리적 연산자는 다음과 같습니다.

논리적 연산자	값(예시)
`GREATER_THAN`	숫자(100)
`LESS_THAN`	숫자(100)
`EQUAL`	숫자(100)
`NOT_EQUAL`	숫자(100)
`IN_RANGE`	튜플([100, 200])
`NOT_IN_RANGE`	튜플([100, 200])
`IN`	리스트(["1", "2", "3"])
`NOT_IN`	리스트(["1", "2", "3"])
`CONTAIN`	문자열("ABC")
`NOT_CONTAIN`	문자열("ABC")
`ANY`	리스트([1, 2, 3])
`ALL`	리스트([1, 2, 3])
`NONE`	리스트([1, 2, 3])

evaluation_spec은 TRIGGER 평가 유형에 trigger가 필요합니다. 트리거에는 유형 및 기본 필터 사양이 포함됩니다. 필터 사양은 field, value 및 operator가 될 수 있습니다.

트리거는 규칙을 평가해야 할지 여부를 동적으로 결정하고 하나만 가질 수 있습니다. 자세한 내용은 트리거 기반 규칙을 참조하세요.

사용할 수 있는 몇 가지 특수 필터 및 일반 그룹 필터를 다음과 같이 정의합니다.

특수 필터

`time_preset`

time_preset 필터는 인사이트 지표를 집계하는 기간을 결정합니다. 현재는 하나의 time_preset만 허용합니다. 이는 트리거에 사용되는 필터(있는 경우)를 포함하여 규칙에 있는 모든 통계 필터에 적용됩니다.

time_preset에 지원되는 유일한 연산자는 EQUAL이며, 이는 인사이트 필터 또는 트리거가 있는 한 필수입니다. 트리거 기반 규칙은 실시간 평가를 수행하기 때문에 TODAY를 포함하는 시간 기본 설정만 지원합니다.

규칙에 대한 시간 기본 설정은 다른 인터페이스와 다르게 작동할 수 있습니다. 여기에서 일부 시간 기본 설정은 오늘의 데이터를 포함합니다. 이는 오늘의 데이터가 하루 한 번보다 더 자주 실행되는 규칙에 중요하기 때문입니다. 다른 인터페이스의 경우, 기본 설정 값 LAST_N_DAYS는 일반적으로 오늘의 데이터를 포함하지 않습니다. 자세한 내용은 아래의 설명을 참조하세요.

{
  "field": "time_preset",
  "value": "TODAY",
  "operator": "EQUAL"
}

시간 기본 설정 값	설명
`LIFETIME`	개체의 수명
`TODAY`	광고 계정의 시간대에서 자정부터 시작되는 현재 날짜
`LAST_2_DAYS`	`YESTERDAY` 및 `TODAY`
`LAST_3_DAYS`	최근 2일 및 `TODAY`
`LAST_7_DAYS`	최근 6일 및 `TODAY`
`LAST_14_DAYS`	최근 13일 및 `TODAY`
`LAST_28_DAYS`	최근 27일 및 `TODAY`
`LAST_30_DAYS`	최근 29일 및 `TODAY`
`THIS_MONTH`	당월(`TODAY` 포함)
`THIS_WEEK_MON_TODAY`	월요일을 주중 첫 요일로 삼는 이번 주(`TODAY` 포함)
`THIS_WEEK_SUN_TODAY`	일요일을 주중 첫 요일로 삼는 이번 주(`TODAY` 포함)
`YESTERDAY`	어제(`TODAY` 제외)
`LAST_2D`	최근 2일(`TODAY` 제외)
`LAST_3D`	최근 3일(`TODAY` 제외)
`LAST_7D`	최근 7일(`TODAY` 제외)
`LAST_14D`	최근 14일(`TODAY` 제외)
`LAST_28D`	최근 28일(`TODAY` 제외)
`LAST_30D`	최근 30일(`TODAY` 제외)
`LAST_ND_14_8`	ROAS에 대한 최근 14~7일
`LAST_ND_30_8`	ROAS에 대한 최근 30~7일
`LAST_ND_60_8`	ROAS에 대한 최근 60~7일
`LAST_ND_120_8`	ROAS에 대한 최근 120~7일
`LAST_ND_180_8`	ROAS에 대한 최근 180~7일
`LAST_ND_LIFETIME_8`	ROAS에 대한 전체 기간~최근 7일
`LAST_ND_60_29`	ROAS에 대한 최근 60~28일
`LAST_ND_120_29`	ROAS에 대한 최근 120~28일
`LAST_ND_180_29`	ROAS에 대한 최근 180~28일
`LAST_ND_LIFETIME_29`	ROAS에 대한 전체 기간~최근 28일

`attribution_window`

attribution_window 필터는 인사이트 지표가 집계되는 검토 기간을 결정합니다. 자세한 내용은 기여 기간의 인사이트 문서를 참조하세요.

현재는 하나의 attribution_window만 허용하며, 이는 규칙에 있는 모든 통계 필터에 적용됩니다. attribution_window에 지원되는 유일한 연산자는 EQUAL이고 일정 기반 규칙에서만 지원합니다.

지정 여부에 관계없이, attribution_window에 유일하게 허용되는 value는 ACCOUNT_DEFAULT입니다.

{
  "field": "attribution_window",
  "value": "ACCOUNT_DEFAULT",
  "operator": "EQUAL"
}

기여 기간 값	설명
`ACCOUNT_DEFAULT`	계정 수준 기여 기간 설정을 사용합니다.

메타데이터 필터

메타데이터 필터를 사용하면 메타데이터 필드의 현재 상태를 기반으로 개체를 필터링할 수 있습니다. 이들은 여러 수준의 필터링도 지원하므로, 프리픽스를 사용하여 개체의 상위 개체 또는 그보다 위에 있는 상위 개체에 메타데이터 필터를 적용할 수 있습니다. 다른 필터는 영향을 받지 않습니다. 인사이트 필터는 여전히 일반 개체에 적용됩니다.

모든 메타데이터 필터는 예약된 규칙에 지원되지만 트리거 규칙에는 하위 세트만 지원됩니다.

예를 들어 목표가 WEBSITE_CLICKS인 광고 캠페인의 광고 세트에 적용되는 규칙을 원하는 경우 다음의 두 가지 필터를 포함할 수 있습니다.

 "filters" : [
  {
    "field": "entity_type",
    "value": "ADSET",
    "operator": "EQUAL",
  },
  {
    "field": "campaign.objective",
    "value": "WEBSITE_CLICKS",
    "operator": "EQUAL"
  }
]

트리거 및 일정 기반 규칙에서 지원하는 메타데이터 필터

메타데이터 필드	설명
`id`*	규칙이 적용되는 특정 정적 개체입니다. 지원되는 프리픽스: 광고, 광고 세트, 광고 캠페인 지원되는 값:`int`, `array(int)` 지원되는 연산자:`EQUAL`, `IN`, `NOT_IN`
`entity_type`*	규칙이 적용되는 개체 수준입니다. 지원되는 프리픽스: 없음 지원되는 값:`AD`, `ADSET`, `CAMPAIGN` 지원되는 연산자:`EQUAL`
`name`	부분 또는 전체 일치에 따른 개체 이름입니다. 지원되는 프리픽스: 광고, 광고 세트, 광고 캠페인 지원되는 값:`string` 지원되는 연산자:`EQUAL`, `CONTAIN`, `NOT_CONTAIN`
`adlabel_ids`	개체의 광고 레이블 ID입니다. 지원되는 프리픽스: 광고, 광고 세트, 광고 캠페인 지원되는 값:`array(int)` 지원되는 연산자:`ANY`, `ALL`, `NONE`
`objective`	개체의 광고 캠페인 목표입니다. 지원되는 프리픽스: 광고 캠페인 지원되는 값:`array(APP_INSTALLS, BRAND_AWARENESS, CONVERSIONS, EVENT_RESPONSES, LINK_CLICKS, ...)` 지원되는 연산자:`IN`, `NOT_IN`
`start_time`	개체의 시작 epoch 시간입니다. 지원되는 프리픽스: 광고 세트, 광고 캠페인 지원되는 값:`int` 지원되는 연산자:`GREATER_THAN`, `LESS_THAN`, `IN_RANGE`, `NOT_IN_RANGE`
`stop_time`	개체의 중지 epoch 시간입니다. 지원되는 프리픽스: 광고 세트, 광고 캠페인 지원되는 값:`int` 지원되는 연산자:`GREATER_THAN`, `LESS_THAN`
`buying_type`	개체의 광고 캠페인 구매 유형입니다. 지원되는 프리픽스: 광고 캠페인 지원되는 값:`array(AUCTION, FIXED_CPM, RESERVED)` 지원되는 연산자:`IN`, `NOT_IN`
`billing_event`	개체 광고 세트의 청구 이벤트입니다. 지원되는 프리픽스: 광고 세트 지원되는 값:`array(APP_INSTALLS, LINK_CLICKS, IMPRESSIONS, ...)` 지원되는 연산자:`IN`, `NOT_IN`
`optimization_goal`	개체 광고 세트의 최적화 목표입니다. 지원되는 프리픽스: 광고 세트 지원되는 값:`array(APP_INSTALLS, LINK_CLICKS, IMPRESSIONS, ...)` 지원되는 연산자:`IN`, `NOT_IN`
`is_autobid`	개체 광고 세트의 자동 입찰 상태입니다. 지원되는 프리픽스: 광고 세트 지원되는 값:`array(bool)` 지원되는 연산자:`IN`, `NOT_IN`
`daily_budget`	개체 광고 세트의 일일 예산입니다. 지원되는 프리픽스: 광고 세트 지원되는 값:`int` 지원되는 연산자:`GREATER_THAN`, `LESS_THAN`, `IN_RANGE`, `NOT_IN_RANGE`
`lifetime_budget`	개체 광고 세트의 총 예산입니다. 지원되는 프리픽스: 광고 세트 지원되는 값:`int` 지원되는 연산자:`GREATER_THAN`, `LESS_THAN`, `IN_RANGE`, `NOT_IN_RANGE`
`spend_cap`	개체 광고 캠페인의 지출 한도입니다. 지원되는 프리픽스: 광고 캠페인 지원되는 값:`int` 지원되는 연산자:`GREATER_THAN`, `LESS_THAN`, `IN_RANGE`, `NOT_IN_RANGE`
`bid_amount`	개체의 입찰 금액입니다. 지원되는 프리픽스: 광고, 광고 세트 지원되는 값:`int` 지원되는 연산자:`GREATER_THAN`, `LESS_THAN`, `IN_RANGE`, `NOT_IN_RANGE`
`created_time`	개체의 생성된 epoch 시간입니다. 지원되는 프리픽스: 광고, 광고 세트, 광고 캠페인 지원되는 값:`int` 지원되는 연산자:`GREATER_THAN`, `LESS_THAN`, `IN_RANGE`, `NOT_IN_RANGE`
`updated_time`	개체의 업데이트된 epoch 시간입니다. 지원되는 프리픽스: 광고, 광고 세트, 광고 캠페인 지원되는 값:`int` 지원되는 연산자:`GREATER_THAN`, `LESS_THAN`, `IN_RANGE`, `NOT_IN_RANGE`

일정 기반 규칙에서만 지원하는 메타데이터 필터

메타데이터 필드	설명
`effective_status`**	개체의 유효한 상태입니다. 지원되는 프리픽스: 광고, 광고 세트, 광고 캠페인 지원되는 값:`array(ACTIVE, PAUSED, ADSET_PAUSED, CAMPAIGN_PAUSED, PENDING_REVIEW, ARCHIVED, DELETED, DISAPPROVED, PREAPPROVED, PENDING_BILLING_INFO)` 지원되는 연산자:`IN`, `NOT_IN`
`placement.page_types`	개체 광고 세트의 노출 위치에 대한 페이지 유형입니다. 지원되는 프리픽스: 광고 세트 지원되는 값:`array(DESKTOPFEED, HOME, INSTAGRAMSTREAM, INSTAGRAMSTORY, ...)` 지원되는 연산자:`ANY`, `ALL`, `NONE`
`budget_reset_period`	개체 광고 세트의 예산 재설정 기간입니다. 지원되는 프리픽스: 광고 세트 지원되는 값:`array(DAY, LIFETIME)` 지원되는 연산자:`IN`, `NOT_IN`
`hours_since_creation`	개체의 `created_time` 이후 경과 시간입니다. 지원되는 프리픽스: 광고, 광고 세트, 광고 캠페인 지원되는 값:`int` 지원되는 연산자:`GREATER_THAN`, `LESS_THAN`, `IN_RANGE`, `NOT_IN_RANGE`
`estimated_budget_spending_percentage`	광고 세트의 일정이 끝날 때까지 지출할 예산의 예상 비율입니다. 이는 광고 세트, 예산 재밸런싱 기능과 동일한 메커니즘을 사용하므로 모든 예산 유형에 사용할 수 있지만 하루당 10시간의 게재 시간이 필요합니다. 지원되는 프리픽스: 광고 세트 지원되는 값:`int` 지원되는 연산자:`GREATER_THAN`, `LESS_THAN`, `IN_RANGE`, `NOT_IN_RANGE`
`audience_reached_percentage`	타겟 규모 대비 광고 세트의 예상 도달 범위 비율입니다. 지원되는 프리픽스: 광고 세트 지원되는 값:`int` 지원되는 연산자:`GREATER_THAN`, `LESS_THAN`, `IN_RANGE`, `NOT_IN_RANGE`
`active_time`	개체의 유효한 상태가 `ACTIVE`가 된 이후로 지난 경과 시간(초)입니다. 개체가 현재 `ACTIVE`가 아닌 경우 `0`을 반환합니다. 지원되는 프리픽스: 광고, 광고 세트, 광고 캠페인 지원되는 값:`int` 지원되는 연산자:`GREATER_THAN`, `LESS_THAN`, `IN_RANGE`, `NOT_IN_RANGE`
`current_time`	현재 epoch 시간입니다. 지원되는 프리픽스: 없음 지원되는 값:`int` 지원되는 연산자:`GREATER_THAN`, `LESS_THAN`, `IN_RANGE`, `NOT_IN_RANGE`

`entity_type` 및 `id`

평가 유형이 SCHEDULE 또는 TRIGGER인 모든 규칙에 대해 entity_type 또는 id 필터를 지정해야 합니다.

entity_type 필터를 지정하면 비즈니스가 규칙을 적용할 동적 개체 수준이 결정됩니다. 예를 들어 entity_type이 AD인 경우 해당 규칙은 광고 계정에 추가되는 모든 새로운 광고를 자동으로 평가합니다. 이는 규칙을 생성하는 시점과 관계없이 수행됩니다. id 필터를 지정하면 규칙은 개체의 정적 리스트에만 적용됩니다.

프리픽스 없이id 필터를 지정하면 Facebook이 규칙을 적용할 개체 수준을 자동으로 계산합니다. 예를 들어 광고 [123, 456]에 규칙을 적용하고자 하는 경우 하나의 필터 필드 id, 값 [123, 456], 연산자 IN만 필요합니다. 이 경우 개체의 초기 정적 리스트를 제공하였으므로 entity_type은 필요하지 않고 Facebook에서 해당 개체로부터 개체 수준을 계산할 수 있습니다.

여러 수준의 필터링과 함께 entity_type 및 id를 사용할 수 있습니다. 예를 들어 일부 지정된 광고 세트에 속한 모든 광고에 규칙을 적용하고자 하는 경우, entity_type 필터 AD와 지정된 광고 세트가 있는 adset.id 필터를 사용할 수 있습니다.

기본적으로 effective_status 필터를 지정하지 않으면, Facebook에서 규칙을 평가할 때 묵시적으로 effective_status 필터를 추가합니다.

활성 개체에 작동하는 모든 실행 유형의 경우, 이 기본 필터는 IN 연산자와 ['ACTIVE', 'PENDING_REVIEW'] 값을 가집니다. 즉, 이 규칙은 활성 게재를 포함하거나 포함할 예정인 개체만 평가합니다. 활성 개체에 작동하지 않는 실행 유형(UNPAUSE)의 경우, Facebook에서는 NOT_IN 연산자 및 ['DELETED', 'ARCHIVED'] 값과 함께 이 필터를 추가합니다. 기본 필터는 Facebook의 실행 유형에 대한 내부 최적화입니다.

인사이트 필터

Facebook에서는 주어진 time_preset에 대해 인사이트 API에서 반환한 현재 값과 비교하여 인사이트 필터를 평가합니다. 이들 필터는 개체의 리스트 또는 수준에 직접 적용되고 여러 수준의 필터링을 지원하지 않습니다. 모든 인사이트 필터는 GREATER_THAN, LESS_THAN, EQUAL, IN_RANGE, NOT_IN_RANGE 연산자를 지원합니다.

여기에 표시되는 단위는 마케팅 API의 통화 기준을 기반으로 합니다. 예를 들어 USD의 경우, 기준 단위가 센트입니다. 즉, 지출 금액 값이 1,000이면 $10.00와 같습니다.

아래의 각 필드에 대한 설명은 인사이트 API 문서를 참조하세요. 이러한 모든 필터는 일정 기반 규칙에서 지원합니다.

인사이트 필터의 리스트와 트리거 기반 규칙에서 이들을 지원하는지 여부는 다음과 같습니다.

인사이트 필드	트리거 기반 규칙에 허용되나요?
`mobile_app_purchase_roas`(예)	아니요
`website_purchase_roas`(예)	아니요
`impressions`	예
`unique_impressions`	예
`clicks`	예
`unique_clicks`	예
`spent`	예
`results`	예
`cost_per`	예
`cpc`	예
`cpm`	예
`ctr`	예
`cpa`	예
`cpp`	예
`reach`	예
`frequency`	예
`leadgen`	예
`link_ctr`	예
`cost_per_unique_click`	예
`result_rate`	예
`mobile_app_install`	예
`cost_per_mobile_app_install`	예
`app_custom_event`	예
`app_custom_event.fb_mobile_achievement_unlocked`	예
`app_custom_event.fb_mobile_activate_app`	예
`app_custom_event.fb_mobile_add_payment_info`	예
`app_custom_event.fb_mobile_add_to_cart`	예
`app_custom_event.fb_mobile_add_to_wishlist`	예
`app_custom_event.fb_mobile_complete_registration`	예
`app_custom_event.fb_mobile_content_view`	예
`app_custom_event.fb_mobile_initiated_checkout`	예
`app_custom_event.fb_mobile_level_achieved`	예
`app_custom_event.fb_mobile_purchase`	예
`app_custom_event.fb_mobile_rate`	예
`app_custom_event.fb_mobile_search`	예
`app_custom_event.fb_mobile_spent_credits`	예
`app_custom_event.fb_mobile_tutorial_completion`	예
`app_custom_event.other`	예
`cost_per_mobile_achievement_unlocked`	예
`cost_per_mobile_activate_app`	예
`cost_per_mobile_add_payment_info`	예
`cost_per_mobile_add_to_cart`	예
`cost_per_mobile_add_to_wishlist`	예
`cost_per_mobile_complete_registration`	예
`cost_per_mobile_content_view`	예
`cost_per_mobile_initiated_checkout`	예
`cost_per_mobile_level_achieved`	예
`cost_per_mobile_purchase`	예
`cost_per_mobile_rate`	예
`cost_per_mobile_search`	예
`cost_per_mobile_spent_credits`	예
`cost_per_mobile_tutorial_completion`	예
`offline_conversion`	아니요
`offline_conversion.add_payment_info`	아니요
`offline_conversion.add_to_cart`	아니요
`offline_conversion.add_to_wishlist`	아니요
`offline_conversion.complete_registration`	아니요
`offline_conversion.initiate_checkout`	아니요
`offline_conversion.lead`	아니요
`offline_conversion.other`	아니요
`offline_conversion.purchase`	아니요
`offline_conversion.search`	아니요
`offline_conversion.view_content`	아니요
`cost_per_offline_conversion`	아니요
`cost_per_offline_other`	아니요
`offsite_conversion`	예
`offsite_conversion.fb_pixel_add_payment_info`	예
`offsite_conversion.fb_pixel_add_to_cart`	예
`offsite_conversion.fb_pixel_add_to_wishlist`	예
`offsite_conversion.fb_pixel_complete_registration`	예
`offsite_conversion.fb_pixel_initiate_checkout`	예
`offsite_conversion.fb_pixel_lead`	예
`offsite_conversion.fb_pixel_purchase`	예
`offsite_conversion.fb_pixel_search`	예
`offsite_conversion.fb_pixel_view_content`	예
`offsite_conversion.fb_pixel_other`	예
`cost_per_add_payment_info_fb`	예
`cost_per_add_to_cart_fb`	예
`cost_per_add_to_wishlist_fb`	예
`cost_per_complete_registration_fb`	예
`cost_per_initiate_checkout_fb`	예
`cost_per_lead_fb`	예
`cost_per_purchase_fb`	예
`cost_per_search_fb`	예
`cost_per_view_content_fb`	예
`link_click`	예
`cost_per_link_click`	예
`like`	예
`offsite_engagement`	예
`post`	예
`post_comment`	예
`post_engagement`	예
`cost_per_post_engagement`	아니요
`post_like`	예
`post_reaction`	예
`view_content`	예
`video_play`	예
`vote`	예
`unique_clicks`	아니요
`reach`	아니요
`lifetime_impressions`	아니요
`lifetime_spent`	아니요
`today_spent`	아니요
`yesterday_spent`	아니요

고급 필터

위의 인사이트 및 메타데이터 필터를 기반으로 고급 필터를 맞춤 설정하고 파생시킬 수 있습니다. 자세한 내용은 고급 평가 사양 필터를 참조하세요.

고급 필터는 GREATER_THAN, LESS_THAN, EQUAL, IN_RANGE, NOT_IN_RANGE 연산자를 지원합니다. 이들은 일정 기반 규칙에서만 지원합니다.

가장 일반적으로 사용되는 일부 고급 필터의 경우, Facebook에서는 필터로서 별칭을 지원합니다.

고급 필터 별칭	파생 위치
`daily_ratio_spent`	`today_spent / adset.daily_budget`
`lifetime_ratio_spent`	`lifetime_spent / adset.lifetime_budget`

평가 사양

특수 필터

time_preset

attribution_window

메타데이터 필터

트리거 및 일정 기반 규칙에서 지원하는 메타데이터 필터

일정 기반 규칙에서만 지원하는 메타데이터 필터

entity_type 및 id

인사이트 필터

고급 필터

`time_preset`

`attribution_window`

`entity_type` 및 `id`