기간

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 연산자는 사전 정의된 기간만 지원하며 맞춤 날짜 문자열과 함께 사용할 수 없습니다.

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

예:

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로 필터링).