측정항목이 0개임

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

검색 결과의 0 측정항목

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

  • 엔티티를 표시할 수 없습니다.
  • 보고서의 기간 내에 일시중지되었습니다.

쿼리 결과를 사용하면 캠페인 실적에 관한 정보를 얻을 수 있습니다. 이 컨텍스트에서는 0 측정항목이 바람직하지 않을 수 있습니다. 더 유용한 보고서를 생성하려면 0 측정항목을 명시적으로 제외하면 됩니다.

술어로 0 측정항목 제외

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

다음 쿼리는 술어를 사용하여 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)부터 월별 데이터를 사용할 수 있습니다. 자세한 내용은 기간을 참고하세요.

이전
세분화
다음
라벨