측정항목이 0개임

이 가이드에서는 Google Ads API 보고서에 측정항목이 0인 행이 표시되는 이유와 쿼리에서 이러한 행을 제외하거나 처리하는 방법을 설명합니다.

검색 결과의 측정항목 0

쿼리를 실행하면 항목의 측정항목이 0일 수 있습니다. 이는 다음과 같은 이유 때문일 수 있습니다.

  • 항목이 게재될 수 없습니다.
  • 보고서의 기간 내에 일시중지되었습니다.

쿼리 결과를 통해 캠페인 실적에 관한 정보를 얻으려는 경우가 많습니다. 이러한 상황에서는 측정항목 0이 바람직하지 않을 수 있습니다. 더 유용한 보고서를 생성하려면 측정항목 0을 명시적으로 제외하면 됩니다.

술어로 측정항목 0 제외

술어는 TRUE, FALSE, UNKNOWN으로 평가되는 표현식입니다. 술어는 WHERE 절에 있는 검색 조건에 사용됩니다. Google Ads 쿼리 언어

다음 쿼리는 술어를 사용하여 측정항목 0을 명시적으로 삭제하는 방법을 보여줍니다.

SELECT
  campaign.id,
  metrics.impressions
FROM campaign
WHERE metrics.impressions > 0

분류하여 측정항목 0 제외

_선택된_ 측정항목이 모두 0인 경우 (측정항목이 0인 반환된 행 참고) 보고서를 분류할 때 측정항목 0은 항상 제외됩니다.

보고서 분류는 검색 쿼리의 SELECT 절에 segments 필드를 포함하여 수행됩니다 (SELECT에서 선택하지 않고 WHERE에서 핵심 날짜 세그먼트를 필터링해도 보고서가 분류되지 않음). 예를 들어 보고서를 segments.date별로 분류하면 측정항목이 날짜별로 하나의 행으로 분류됩니다. 측정항목이 없는 날짜는 이러한 보고서에 반환되지 않습니다.

다음 쿼리의 경우 보고서에 측정항목이 0인 행이 포함되지 않습니다.

SELECT
  campaign.name,
  metrics.impressions,
  segments.date
FROM campaign
WHERE segments.date DURING LAST_30_DAYS

측정항목이 0인 반환된 행

선택한 측정항목이 모두 0인 행은 분류할 때 반환되지 않습니다. 예를 들어 metrics.impressions, metrics.clicks, metrics.conversions를 선택하는 다음 쿼리를 살펴보세요.

SELECT
  ad_group_criterion.criterion_id,
  metrics.impressions,
  metrics.clicks,
  metrics.conversions,
  segments.date
FROM keyword_view
WHERE segments.date BETWEEN '2026-01-01' AND '2026-01-31'

결과 보고서에는 선택한 세 가지 측정항목이 모두 0인 행이 포함되지 않지만, 선택한 세 가지 측정항목 중 하나 이상이 0보다 큰 행은 반환됩니다.

데이터 보관 기간을 초과하는 과거 데이터를 쿼리할 때는 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년간 보관됩니다. 예를 들어 11년 조회 기간의 컷오프가 2015-03-22 (또는 2015-03-01)인 경우 컷오프 후 첫 번째 전체 달력 월 (2015-04-01)부터 월별 데이터를 사용할 수 있습니다. 자세한 내용은 기간을 참고하세요.

이전
세분화
다음
라벨