측정항목이 0개임

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

검색 결과의 측정항목이 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)부터 월별 데이터를 사용할 수 있습니다. 자세한 내용은 기간을 참고하세요.

도달범위 측정항목 표시 중지 및 0 값

노출수를 게재하지 않은 항목 외에도 도달범위 데이터가 표시되지 않는 경우 도달범위 측정항목 (예: metrics.unique_users 및 게재빈도 버킷 측정항목 metrics.unique_users_two_plus~metrics.unique_users_ten_plus)이 0으로 표시되거나 생략될 수 있습니다. metrics.unique_users 측정항목 (및 metrics.unique_users_info)은 디스플레이, 동영상, 디맨드젠 캠페인, 앱 캠페인에서 지원되는 반면, metrics.unique_users_*_plus 게재빈도 버킷 측정항목 (및 metrics.unique_users_*_plus_info)은 동영상 캠페인에 적용됩니다.

도달범위 제한은 다음과 같은 여러 가지 이유로 발생합니다.

  • 개인 정보 보호 기준: 사용자 수가 개인 정보 보호 기준 (예: k-익명성)을 충족하지 못하는 경우 사용자 신원을 보호하기 위해 도달범위 데이터가 표시되지 않습니다.
  • 품질 기준: 데이터가 품질 기준을 충족하지 않으면 도달범위 데이터가 보류될 수 있습니다.
  • 데이터 보관: 이전 도달범위 데이터는 3년 (36개월) 동안 보관됩니다. 이 3년 보관 기간을 초과하는 날짜에 걸친 쿼리는 도달범위 측정항목을 반환할 수 없습니다. 36~37개월 전의 날짜를 포함하는 쿼리는 이전 섹션에서 설명한 DateRangeError.REQUESTED_DATE_GRANULARITY_NOT_SUPPORTED를 반환하지 않고 성공하지만 도달범위 측정항목을 생략하고 컴패니언 도달범위 메타데이터가 선택된 경우 DATE_RANGE_BEYOND_RETENTION를 반환합니다.

v26 이상에서는 각 순 사용자 도달범위 측정항목에 ReachMetricInfo 유형의 컴패니언 메타데이터 필드(예: metrics.unique_users_info 및 metrics.unique_users_two_plus_info~metrics.unique_users_ten_plus_info)가 있습니다.

Google Ads Query Language (GAQL)에서 컴패니언 도달범위 필드는 SELECT 절에서 직접 선택한 MESSAGE 측정항목입니다 (예: metrics.unique_users_info). GAQL에서 중첩된 메시지 필드를 선택하면 UNRECOGNIZED_FIELD로 인해 실패하므로 SELECT 절에 .reach_metric_states를 추가하지 마세요. 대신 metrics.unique_users_info를 선택하면 측정항목이 억제되었는지 또는 완료되었는지를 설명하는 ReachMetricState 유형의 반복된 enum 필드 reach_metric_states가 포함된 ReachMetricInfo 메시지가 반환됩니다.

도달범위 측정항목이 표시되지 않거나 보관 기간(PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION 또는 DATE_RANGE_BEYOND_RETENTION)을 벗어날 때마다 Metrics의 optional int64 필드가 설정 해제됩니다 (필드 존재 여부가 확인되지 않으면 0로 평가됨). 반면 LOW_QUALITY는 여전히 숫자 측정항목을 채웁니다.

  • COMPLETE: 도달범위 측정항목이 완료되었으며 제외가 없습니다.
  • PRIVACY_SUPPRESSION: 개인 정보 보호 제약 조건으로 인해 도달범위 데이터가 표시되지 않았습니다.
  • QUALITY_SUPPRESSION: 데이터 품질 문제로 인해 도달범위 데이터가 표시되지 않았습니다.
  • LOW_QUALITY: 도달범위 측정항목이 계산되었지만 품질이 낮은 것으로 표시됩니다.
  • DATE_RANGE_BEYOND_RETENTION: 기간이 도달범위 데이터의 3년 데이터 보관 한도를 벗어나므로 도달범위 측정항목을 사용할 수 없습니다.

도달범위 측정항목과 함께 제공되는 메타데이터 필드를 모두 선택하면 애플리케이션에서 실제 도달범위가 0인 경우와 도달범위 값이 표시되지 않는 경우를 구분할 수 있습니다.

SELECT
  campaign.id,
  campaign.name,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date DURING LAST_30_DAYS
이전
세분화
다음
라벨