Google Ads 쿼리 언어를 사용하면 다음과 같은 방법으로 기간을 지정할 수 있습니다.
기간 맞춤설정
날짜는 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.weeksegments.monthsegments.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로 세그먼트를 나누거나 월별 미만 기간을 기준으로 필터링하는 쿼리는DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED오류로 실패합니다 v24 이상에서 (또는 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를 기준으로 필터링합니다.