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