결과 순서 지정 및 제한

Google Ads 쿼리 언어를 사용하면 ORDER BY 및 LIMIT 절을 사용하여 쿼리 응답에서 반환되는 행을 정렬하고 제한할 수 있습니다.

결과 정렬

쉼표로 구분된 하나 이상의 시퀀스로 구성된 ORDER BY 절을 사용하여 응답에서 행의 순서를 지정할 수 있습니다.

FieldName (ASC | DESC)?

필드 이름 뒤에 ASC 또는 DESC를 지정하지 않으면 Google Ads API가 기본적으로 ASC를 사용합니다. ORDER BY 절을 완전히 생략하면 반환된 행의 순서가 결정되지 않습니다.

다음 ORDER BY 절은 노출수를 내림차순으로, 캠페인 이름을 오름차순으로 정렬하여 캠페인 수준 보고서를 정렬합니다.

ORDER BY metrics.impressions DESC, campaign.name ASC
  • 선택되지 않은 리소스의 속성별
  • 선택되지 않은 측정항목별
  • 선택되지 않은 세그먼트별
  • 다음 유형의 필드:
    • MESSAGE
    • 반복되는 입력란
    • 반복되는 입력란의 속성

결과 수 제한

양의 정수 (1 이상, LIMIT 0은 유효하지 않음)와 함께 LIMIT 절을 사용하여 반환되는 총 결과 수를 제한할 수 있습니다. 이를 결과 정렬과 결합하면 지난 30일 동안 노출수가 가장 높은 5개의 캠페인이 포함된 보고서와 같은 '상위 N' 보고서를 생성할 수 있습니다.

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

검색 결과 필터링

WHERE 필터를 ORDER BY 및 LIMIT와 결합할 때는 다음 필터링 제한사항에 유의하세요.

  • '핵심' 날짜 세그먼트 필드 (segments.date, segments.week, segments.month, segments.quarter, segments.year)를 제외하고 세그먼트를 선택하지 않고는 필터링할 수 없습니다.
  • 복합 MESSAGE 필드에서 직접 필터링할 수 없습니다 (Int64Value, StringValue와 같은 기본 래퍼 메시지 제외). 대신 기본 스칼라 (int64, string, bool) 또는 enum 하위 필드를 필터링하세요.
  • 반복 필드의 복합 MESSAGE 속성은 필터링할 수 없습니다. 기본 스칼라 (int64, string, bool), enum 또는 기본 래퍼 하위 필드만 필터링할 수 있습니다.
이전
대소문자 구분