Google Ads 쿼리 검사기는 개발자가 애플리케이션에 통합하기 전에 Google Ads 쿼리 언어 (GAQL) 쿼리를 구성하고 검증할 수 있도록 설계된 대화형 도구입니다. GAQL 쿼리 문자열을 입력하고 유효성에 대한 즉각적인 의견을 받을 수 있으므로 개발 프로세스 초기에 구문 오류, 필드 비호환성 및 기타 문제를 발견하는 데 도움이 됩니다.
혜택
- 오류 방지: 잘못된 쿼리가 애플리케이션에 통합되기 전에 미리 발견하여 런타임 오류 및 API 호출 실패를 줄입니다.
- 개발 속도 향상: 전체 API 요청 및 응답 주기의 오버헤드 없이 GAQL 문을 빠르게 테스트하고 디버그할 수 있습니다.
- GAQL 제약조건 이해: 개발자가 호환되는 필드와 리소스가 서로 어떻게 관련되는지에 관한 복잡한 규칙을 학습하는 데 도움이 됩니다.
- 쿼리 디버깅: 쿼리가 잘못된 경우 일반 API 오류보다 더 자세하고 때로는 유효한 대안을 제안하는 구체적인 오류 메시지를 제공합니다.
- 리소스 효율성: 실패할 쿼리로 불필요한 API 호출을 방지합니다.
작동 방식
쿼리 검사기는 Google Ads API의 스키마와 Google Ads 쿼리 언어에 정의된 규칙에 따라 GAQL 쿼리를 파싱합니다. 이 도구는 GoogleAdsFieldService에서 액세스할 수 있는 메타데이터를 사용하여 다음을 포함한 검사를 실행합니다.
- 구문 및 구조: 쿼리가
SELECT,FROM,WHERE,ORDER BY,LIMIT와 같은 절의 올바른 사용 및 순서를 포함하여 올바른 GAQL 문법을 따르는지 확인합니다. - 필드 유효성: 지정된 모든 필드 (리소스, 세그먼트, 측정항목)가 존재하고 철자가 올바른지 확인합니다.
- 리소스 호환성:
SELECT절에서 선택한 필드가FROM절에 지정된 기본 리소스와 호환되는지 확인합니다. - 세그먼트 및 측정항목 호환성: 동일한 쿼리에서 함께 사용되는 세그먼트와 측정항목이 서로 호환되고
FROM절의 리소스와 호환되는지 확인합니다. - 절 요구사항:
WHERE또는ORDER BY절에 사용된 특정 필드가SELECT절에도 있어야 하는 요구사항과 같은 규칙을 검증합니다. - 연산자 사용:
WHERE절 조건 내에서 연산자가 올바르게 사용되었는지 확인합니다.
쿼리가 유효하면 도구에서 이를 확인합니다. 문제가 발견되면 문제를 정확히 파악하는 데 도움이 되도록 설계된 오류 메시지를 제공하며, 때로는 특정 측정항목에 호환되는 리소스와 같은 수정사항을 제안하기도 합니다.
시작하기
Google Ads 쿼리 검사기를 사용하려면 다음 단계를 따르세요.
- 쿼리 검사기로 이동합니다.
- GAQL 쿼리를 입력합니다.
- 쿼리 검증 버튼을 클릭합니다.
- 쿼리 검사기 위젯 아래에 표시되는 검증 메시지를 검토합니다. 성공 메시지는 쿼리가 유효함을 나타냅니다. 그렇지 않으면 문제를 설명하는 오류 메시지가 표시됩니다. 오류 메시지를 통해 쿼리를 수정할 수 있습니다. 예를 들어 필드 비호환성 오류는 쿼리하려는 측정항목 또는 세그먼트와 호환되는 대체 리소스를 나열할 수 있습니다.
GAQL 개념 및 검증에 대한 자세한 설명은 GAQL 동영상 가이드를 참고하세요.