Google Ads API 상담사 기술

Google Ads API 에이전트 스킬은 Google Ads API 관련 지식, 안내, 워크플로를 포함한 이식 가능한 독립형 모듈입니다. Google Ads API 에이전트 스킬은 개방형 에이전트 스킬 표준을 지원하는 AI 어시스턴트와 호환됩니다. Google Antigravity 및 Claude Code를 비롯하여

이러한 에이전트 스킬은 AI 어시스턴트가 Google Ads API 권장사항을 이해하고, 도구를 구성하고, 더 높은 정확도와 더 낮은 토큰 비용으로 워크플로를 실행하도록 설계되었습니다. 사용 가능한 스킬 목록은 사용 가능한 스킬을 참고하세요.

시작하기

개발 환경에 적합한 에이전트 스킬을 설치합니다.

Google Ads API 에이전트 스킬 설치

대부분의 경우 명령어 하나로 원하는 편집기에 Google Ads API 에이전트 스킬을 설치할 수 있습니다.

Antigravity

Google Ads API 에이전트 스킬은 Antigravity용 Build with Google 통합 번들 중 하나로 포함되어 있습니다. 다음 두 지점에서 전역 수준 액세스를 위해 이 번들을 사용 설정할 수 있습니다.

  • 온보딩 중: Google Ads API 스택의 체크박스를 선택합니다.
  • 설정:
    1. 설정 > 맞춤설정 으로 이동합니다.
    2. Build with Google 플러그인에서 맞춤설정을 클릭한 후 Google Ads API 통합의 다운로드를 클릭합니다.

프로젝트 수준 액세스를 선호하는 경우 프로젝트 디렉터리에서 다음 명령어를 실행합니다.

npx skills add google/skills --agent=antigravity

Claude Code 

claude plugin marketplace add google/skills
claude plugin install google-ads@skills

Codex 

npx skills add google/skills

커서

커스텀 규칙의 편집기 설정에서 스킬의 GitHub 저장소 엔드포인트 (예: https://github.com/google/skills)를 추가하여 Google Ads API 에이전트 스킬을 직접 설치할 수 있습니다. 자세한 내용은 커서 규칙 문서를 참고하세요.

다른 에이전트

개방형 에이전트 스킬 표준을 지원하는 다른 AI 어시스턴트의 경우 NPX를 사용하여 스킬을 설치할 수 있습니다.

npx skills add google/skills

Google Ads API 에이전트 스킬 업데이트

update 명령어를 실행하여 사용 가능한 모든 업데이트를 가져오고 오래된 스킬을 정리할 수 있습니다.

Antigravity

Build with Google 을 통해 사용 설정된 통합은 편집기에서 자동으로 관리 및 업데이트됩니다.

npx 명령어를 사용하여 에이전트 스킬을 설치한 경우 update 명령어를 실행하여 사용 가능한 모든 업데이트를 가져올 수 있습니다.

npx skills update --all

Claude Code 

claude plugin update google-ads@skills

Codex 

npx skills update --all

커서 

npx skills update --all

다른 에이전트

개방형 에이전트 스킬 표준을 지원하는 다른 AI 어시스턴트의 경우 NPX를 사용하여 모든 활성 스킬을 업데이트할 수 있습니다.

npx skills update --all

Google Ads API 에이전트 스킬 사용

AI 어시스턴트는 스킬의 설명이 현재 요청과 일치하는 것으로 감지될 때마다 스킬을 자동으로 사용하도록 설계되었습니다. 프롬프트 컨텍스트가 Google Ads API 작업과 일치하지 않는 한 전역적으로 설치된 스킬은 관련 없는 프로젝트에서 휴면 상태로 유지됩니다.

에이전트 채팅에 /를 입력하고 스킬 이름을 검색하여 스킬을 수동으로 호출할 수도 있습니다.

스킬의 핵심 구성요소

각 에이전트 스킬은 AI 어시스턴트에게 다음 구성요소를 제공하는 특화된 패키지입니다.

  • 특화된 안내: 컨텍스트 윈도우에 삽입되어 어시스턴트가 GAQL 쿼리를 생성하고, OAuth 사용자 인증 정보를 구성하고, 일반적인 오류 코드를 처리하도록 안내하는 자세한 프롬프트 안내입니다.
  • 권장사항: Google Ads API DevRel팀에서 정의한 표준 성능, 보안, 통합 권장사항입니다.
  • 자동화 스크립트: 로컬에서 작업을 실행하기 위해 스킬 패키지에 포함된 실행 가능한 스크립트 (예: 환경 유효성 검사 또는 작업공간 설정)입니다.

스킬 사용의 이점

에이전트 스킬은 모든 대화에 대량의 안내를 로드하는 오버헤드 없이 필요할 때 특화된 지식으로 어시스턴트의 기능을 확장합니다.

토큰 비용 절감

기존 AI 통합은 대량의 문서를 미리 로드하는 경우가 많아 토큰을 많이 소모하고 세션 비용을 증가시킵니다. 에이전트 스킬은 단계적 공개 를 사용하여 이 오버헤드를 최소화합니다.

  • AI 어시스턴트는 처음에 스킬의 이름과 설명을 확인하여 요청과 관련이 있는지 확인합니다.
  • 어시스턴트가 특정 작업에 필요하다고 판단하는 경우에만 스킬의 전체 안내와 참조가 활성 컨텍스트 윈도우에 추가되어 컨텍스트 공간을 절약합니다.

AI 기반 구현

문서를 수동으로 검색하는 대신 자연어로 의도를 설명할 수 있습니다. 스킬은 AI 어시스턴트가 다음과 같은 작업을 수행하도록 안내합니다.

  • 내 계정에서 캠페인 실적 측정항목을 가져오는 GAQL 쿼리를 생성합니다.
  • 클라이언트 라이브러리를 사용하여 새 캠페인을 만드는 Python 스크립트를 작성합니다.
  • Google Ads API를 사용하여 캠페인 전환 및 진단 데이터를 가져옵니다.

사용 가능한 스킬의 전체 목록은 사용 가능한 스킬을 참고하세요.

Google Ads API MCP 서버와 함께 스킬 사용

에이전트 스킬은 Google Ads API 모델 컨텍스트 프로토콜 (MCP) 서버를 보완하도록 설계되었습니다.

  • Google Ads API MCP 서버: AI 지원 개발 워크플로를 위해 설계되어 AI 어시스턴트가 Google Ads API 리소스, 캠페인, 측정항목과 프로그래매틱 방식으로 상호작용할 수 있습니다.
  • Google Ads API 에이전트 스킬: 토큰 효율적인 단계적 공개를 통해 어시스턴트가 작업을 수행하도록 안내하는 프롬프트 안내와 권고 사항을 제공합니다. MCP 서버 및 클라이언트 라이브러리와 같은 도구를 효과적으로 사용하는 방법을 에이전트에게 안내합니다.

사용 가능한 스킬

Google Ads API팀은 Google Ads API로 빌드하기 위한 스킬 모음을 제공합니다.

스킬 설명
google-ads-api-mcp-setup Google Ads API 모델 컨텍스트 프로토콜 (MCP) 서버를 설정하고 구성하는 데 도움이 되며 로컬 환경에서 인증 및 구성을 간소화합니다.
google-ads-api-quickstart 개발자 환경 설정, 사용자 인증 정보 구성, Google Ads API에 대한 첫 번째 API 호출을 안내합니다.

다음 단계