평가 사양 필터

예약 기반 규칙에서는 더 고급 유형의 필터 필드를 사용할 수 있습니다.

프리픽스가 표시된 인사이트 필드

인사이트 필터에 특정 유형의 프리픽스를 설정할 수 있습니다. 이는 다단계 필터링을 수행하기 위한 메타데이터 필터용 프리픽스 세트와 유사합니다.

필터에 개체 수준의 프리픽스를 설정하여 인사이트 다단계 필터링을 활용할 수 있습니다. 예를 들어 광고 규칙은 광고 세트 또는 광고 캠페인 성과를 기준으로 필터링할 수 있습니다. 또한 필터에 기여 기간과 시간 기본 설정 프리픽스를 지정할 수 있습니다. 이는 특정 필터의 규칙 기여 기간과 시간 기본 설정을 재정의하는 데 사용됩니다.

사용 방법

프리픽스는 선택 사항입니다. 필드에 다음과 같은 프리픽스를 지정할 수 있습니다.

  • 개체 수준 프리픽스
  • 기여 기간 프리픽스
  • 시간 기본 설정 프리픽스

이 순서를 유지하기만 한다면 위의 옵션을 모두 사용하거나 아무것도 사용하지 않거나 조합하여 사용할 수 있습니다. 필드는 다음과 같은 형식을 취해야 합니다.

{ object_level_prefix? } {attribution_window_prefix?} { time_preset_prefix? } { field_name }

프리픽스가 표시된 인사이트 필드의 올바른 예시와 잘못된 예시는 다음과 같습니다. 또한 어떤 메타데이터 필터를 지원하는지 보여드리기 위해 프리픽스가 표시된 메타데이터 필드의 올바른 예시와 잘못된 예시도 제공합니다.

인사이트 필드 spent의 예
좋은 예

adset.yesterday_spent - 어제 광고 세트 수준에서 지출한 총금액

adset.spent - 광고 세트 수준에서 지출한 총금액

yesterday_spent - 어제 지출한 총금액

campaign.28d_view_1d_click:lifetime_results - 전체 기간에 걸쳐 광고 세트 수준의 총 결과. 기여 기간은 조회 후 28일, 클릭 후 1일입니다.

campaign.lifetime_spent - 전체 기간에 걸쳐 광고 캠페인 수준에서 지출한 총금액

잘못된 예

lifetime_campaign.spent - 시간 기본 설정 프리픽스는 개체 수준 프리픽스 앞에 올 수 없습니다.

lifetime_today_spent - 시간 기본 설정 프리픽스를 2개 사용할 수 없습니다.

ad.adset.spent - 개체 수준 프리픽스를 2개 사용할 수 없습니다.

yesterday.adset_spent - 구분 문자가 잘못되었습니다.


메타데이터 필드 daily_budget의 예
좋은 예

adset.daily_budget - 광고 세트의 일일 예산

daily_budget - 일일 예산

잘못된 예

yesterday_daily_budget - 메타데이터 필드에서는 시간 기본 설정 프리픽스를 사용할 수 없습니다.

ad.daily_budget - 광고에는 일일 예산이 없습니다.

개체 수준 프리픽스

프리픽스개체 유형개체 유형에 유효

ad.

광고

광고

adset.

광고 세트

광고, 광고 세트

campaign.

캠페인

광고, 광고 세트, 캠페인

기여 기간 프리픽스

기여 기간 프리픽스 설명

account_default:

계정 수준 기여 기간 설정을 사용합니다.

default:

Facebook 기본 기여 기간은 조회 후 1일, 클릭 후 28일입니다.

inline:

인라인 기여만 적용됩니다(조회 후 0일, 클릭 후 0일).

1d_view:

조회 후 1일, 클릭 후 0일입니다.

7d_view:

조회 후 7일, 클릭 후 0일입니다.

28d_view:

조회 후 28일, 클릭 후 0일입니다.

1d_click:

조회 후 0일, 클릭 후 1일입니다.

7d_click:

조회 후 0일, 클릭 후 7일입니다.

28d_click:

조회 후 0일, 클릭 후 28일입니다.

1d_view_1d_click:

조회 후 1일, 클릭 후 1일입니다.

7d_view_1d_click:

조회 후 7일, 클릭 후 1일입니다.

28d_view_1d_click:

조회 후 28일, 클릭 후 1일입니다.

1d_view_7d_click:

조회 후 1일, 클릭 후 7일입니다.

7d_view_7d_click:

조회 후 7일, 클릭 후 7일입니다.

28d_view_7d_click:

조회 후 28일, 클릭 후 7일입니다.

7d_view_28d_click:

조회 후 7일, 클릭 후 28일입니다.

28d_view_28d_click:

조회 후 28일, 클릭 후 28일입니다.

시간 기본 설정 프리픽스

이 리스트는 유효한 시간 기본 설정 값의 리스트와 동일하지만 소문자로 바꾸고 구분 문자를 추가하였습니다.

프리픽스 설명

lifetime_

개체의 수명

today_

광고 계정의 시간대에서 자정부터 시작되는 현재 날짜

last_2_days_

YESTERDAYTODAY

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_20_

ROAS에 대한 최근 120~28일

last_nd_180_29_

ROAS에 대한 최근 180~28일

last_nd_lifetime_29_

ROAS에 대한 전체 기간~최근 28일

집계

여러 광고 개체에 대해 일부 인사이트 필드를 집계할 수 있습니다. 그러면 특정 광고 개체의 하위 집합의 지표에 대해 필터를 생성할 수 있습니다. 예를 들어 여러 광고에 대한 전체 도달 범위 또는 여러 광고 세트에 대한 총 클릭수가 해당합니다.

clicks 등의 지표는 단순 합계로 계산되지만 reach 등의 지표는 다르게 계산됩니다. reach는 고유 노출을 기준으로 하기 때문에 여러 광고 개체에 대한 집계에서는 중복 사용자가 삭제됩니다.

사용 방법

집계된 필드는 aggregate({ field })의 형식을 취합니다. field에는 기여 기간과 시간 기본 설정 프리픽스가 포함될 수 있습니다. 집계될 광고 개체 세트는 다른 필수 필터 필드 aggregation_id로 결정됩니다.

집계 필드의 예

좋은 예

aggregate(reach)

aggregate(lifetime_reach)

잘못된 예

aggregate(daily_budget)

aggregate(adset.reach)

집계 ID 필터

aggregation_id 필터는 집계할 광고 개체를 지정합니다. IN 연산자와 ID 리스트만 값으로 지원합니다. ID는 광고, 광고 세트 또는 광고 캠페인의 ID일 수 있지만 모두 동일한 개체 수준이어야 합니다.

aggregation_id 필터의 예

{
  "field": "aggregation_id",
  "operator": "IN",
  "value": [1234, 5678]
},
{
  "field": "aggregate(reach)",
  "operator": "GREATER_THAN",
  "value": 100
}

지원되는 필드

  • clicks
  • cpc
  • cpm
  • cpp
  • ctr
  • frequency
  • impressions
  • mobile_app_purchase_roas
  • reach
  • result_rate
  • spent
  • unique_clicks
  • unique_impressions
  • website_purchase_roas
  • cost_per_unique_click

공식 필드

단순한 산술식을 필드로 설정할 수 있습니다. 예를 들어 두 개의 숫자 필드 사이의 비율을 찾는 데 사용할 수 있습니다.

이는 인사이트 필드와 숫자 메타데이터 필드의 하위 집합에서 작동합니다. 전체 지원 리스트는 아래와 같습니다.

사용 방법

공식 필드는 필드 또는 상수와 문법적으로 올바른 연산자로 구성되며 공백으로 구분됩니다. +-*/ 연산자를 지원합니다. 예를 들어 특정 필드에 가중치를 부여하거나 오프셋 역할을 하는 상수를 추가할 수 있습니다.

이 경우의 필드는 프리픽스를 모두 설정할 수 있으므로 유효한 개체 수준과 시간 기본 설정 프리픽스를 추가할 수 있습니다.

현재는 공식에서 상수가 아닌 필드를 최대 6개 허용합니다. 상수는 원하는 만큼 추가할 수 있습니다.

today_spent / adset.today_spent

0.8 * cpc + 0.2 * cpm

{ field_or_constant_1 } { + | - | * | / } { field_or_constant_2 }

공식의 예

좋은 예

today_spent / adset.daily_budget - 일일 지출 비율

clicks / adset.clicks - 광고 세트 클릭수 대비 클릭수 비율

today_impressions / yesterday_impressions - 어제의 노출 횟수 대비 오늘의 노출 횟수 비율

today_impressions / aggregate(today_impressions) - 집계된 노출 횟수 대비 오늘의 노출 횟수 비율

(adset.spent - spent) - API 응답으로 공식을 수신할 때 괄호가 허용되며 공식이 괄호로 묶입니다.

잘못된 예

(clicks + cpc + cpm + ctr + cpa + cpp) / cost_per - 최대 6개의 필드를 사용할 수 있습니다.

today_impressions/yesterday_impressions - 용어는 공백으로 구분해야 합니다.

유효한 숫자 메타데이터 필드

필드개체 유형에 유효

bid_amount

광고, 광고 세트

daily_budget

광고 세트

lifetime_budget

광고 세트

spend_cap

캠페인