기간

Google Ads Query Language를 사용하면 다음과 같은 방법으로 기간을 지정할 수 있습니다.

맞춤 기간

ISO 8601 확장 (YYYY-MM-DD) 또는 기본 (YYYYMMDD) 형식으로 날짜를 지정할 수 있습니다. 가독성을 위해 확장 형식(YYYY-MM-DD)을 사용하는 것이 좋습니다. 커스텀 날짜 문자열과 함께 BETWEEN 또는 비교 연산자 (=, >, >=, <, <=)를 사용합니다.

segments.date BETWEEN '2026-01-01' AND '2026-01-31'
segments.date >= '20260701' AND segments.date <= '20260731'

사전 정의된 기간

사전 정의된 기간 리터럴과 함께 DURING 연산자를 사용합니다. DURING 연산자는 사전 정의된 기간만 지원하며 커스텀 날짜 문자열과 함께 사용할 수 없습니다.

유효한 사전 정의된 기간 목록은 다음과 같습니다.

기간 보고서가 생성되는 대상
TODAY 오늘만
YESTERDAY 어제만
LAST_7_DAYS 오늘을 제외한 지난 7일입니다.
LAST_BUSINESS_WEEK 이전 영업주의 월요일부터 금요일까지의 5일 영업주입니다.
THIS_MONTH 이번 달의 모든 날짜입니다.
LAST_MONTH 지난달의 모든 날짜입니다.
LAST_14_DAYS 오늘을 제외한 지난 14일입니다.
LAST_30_DAYS 오늘을 제외한 지난 30일입니다.
THIS_WEEK_SUN_TODAY 이전 일요일과 현재 날짜 사이의 기간입니다.
THIS_WEEK_MON_TODAY 이전 월요일과 현재 날짜 사이의 기간입니다.
LAST_WEEK_SUN_SAT 이전 일요일부터 시작되는 7일 기간입니다.
LAST_WEEK_MON_SUN 이전 월요일부터 시작되는 7일 기간입니다.

예:

segments.date DURING LAST_30_DAYS

사전 정의된 기간

일부 날짜 필드는 사전 정의된 기간을 나타냅니다.

  • segments.week
  • segments.month
  • segments.quarter

맞춤 기간 문자열(=, BETWEEN, >=, <=, > 또는 < 사용)을 사용하여 이러한 세그먼트를 필터링할 때는 기간의 첫 번째 날짜를 지정해야 합니다.

  • segments.week: 해당 주의 월요일 (예: '2026-05-04')
  • segments.month: 월의 첫 번째 날 (YYYY-MM-01, 예: '2026-05-01')
  • segments.quarter: 분기의 첫 번째 날 (YYYY-01-01, YYYY-04-01, YYYY-07-01 또는 YYYY-10-01)입니다.

기간의 첫 번째 날이 아닌 날짜를 지정하면 QueryError.MISALIGNED_DATE_FOR_FILTER 오류가 반환됩니다. 사전 정의된 기간과 함께 DURING 연산자를 사용하여 이러한 세그먼트를 필터링할 수도 있습니다.

예를 들어 2026년 5월을 지정하려면 해당 월의 첫 번째 날을 지정하는 다음 조건을 사용합니다.

segments.month = '2026-05-01'

이전 전환 확인 기간 한도

이전 보고 데이터의 사용 가능 여부는 선택되거나 필터링된 날짜 세그먼트의 세부사항에 따라 다릅니다.

  • 일별, 주별, 시간별 세분화 (segments.date, segments.week, segments.hour): 최대 37개월의 전환 확인 기간을 지원합니다. 37개월 기간을 초과하는 날짜에 대해 segments.date, segments.week 또는 segments.hour로 분류하거나 월 미만의 기간으로 필터링하는 쿼리는 v24 이상에서 DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED(또는 v23에서 DateRangeError.UNKNOWN) 오류가 발생합니다.
  • 월별, 분기별, 연도별 또는 세분화되지 않은 세분화 수준 (segments.month, segments.quarter, segments.year 또는 날짜 세그먼트 없음): 최대 11년의 이전 데이터를 지원합니다. 37개월 기간을 초과하는 이전 데이터를 쿼리하려면 segments.month, segments.quarter, segments.year로 분류하거나 SELECT에서 날짜 세그먼트를 생략하고 WHERE 기간이 월의 첫날에 시작하여 월의 마지막 날에 끝나도록 합니다 (또는 segments.month, segments.quarter, segments.year로 필터링).