Google 애널리틱스 AI 에이전트 기술

더 높은 정확성과 더 낮은 토큰 오버헤드로 Google 애널리틱스 보고 및 속성 관리 통합을 빌드하려면 AI 코딩 에이전트에 Google 애널리틱스 AI 에이전트 기술을 제공하세요. Google 애널리틱스 Data API 및 Google Analytics Admin API를 사용하여 빌드하는 개발자를 위해 설계된 Google 애널리틱스 AI 에이전트 기술은 이식 가능하고 독립적인 안내, 워크플로, 클라이언트 라이브러리 참조 모듈입니다.

이러한 AI 에이전트 스킬은 Google Antigravity, Claude Code, Codex, Cursor를 비롯한 개방형 Agent Skills 표준을 지원하는 AI 코딩 에이전트와 호환됩니다. 게시된 스킬 목록은 사용 가능한 스킬을 참고하세요.

시작하기 전에

Google 애널리틱스 AI 에이전트 기술을 설치하고 실행하기 전에 다음 기본 요건을 완료하세요.

  • Google Antigravity, Claude Code, Codex, Cursor와 같이 개방형 Agent Skills 표준을 지원하는 AI 코딩 에이전트를 설치합니다.
  • 명령줄에서 기술을 설치하고 업데이트하는 npx 명령어가 포함된 Node.js를 설치합니다.
  • API 워크플로를 실행할 때 Google 애널리틱스 속성에 액세스할 수 있는 프로젝트를 만들거나 선택합니다.

시작하기

개발 환경에서 Google 애널리틱스 AI 에이전트 기술을 설치, 업데이트, 호출합니다.

Google 애널리틱스 AI 에이전트 기술 설치

npx 명령어를 사용하여 프로젝트 디렉터리에 Google 애널리틱스 기술 모음을 설치하거나 편집기를 직접 구성합니다.

Antigravity

프로젝트 디렉터리에서 다음 명령어를 실행합니다.

npx skills add google/skills/skills/analytics --agent=antigravity

Claude Code

프로젝트 디렉터리에서 다음 명령어를 실행합니다.

npx skills add google/skills/skills/analytics --agent=claude-code

Codex

프로젝트 디렉터리에서 다음 명령어를 실행합니다.

npx skills add google/skills/skills/analytics --agent=codex

커서

커스텀 규칙 아래의 에디터 설정에 기술 저장소 URL(https://github.com/google/skills)을 추가합니다. 자세한 내용은 GitHub에서 기술 설치에 관한 Cursor 문서를 참고하세요.

또는 npx 명령어를 사용하여 프로젝트 디렉터리에 기술을 설치합니다.

npx skills add google/skills/skills/analytics --agent=cursor

다른 에이전트

개방형 Agent Skills 표준을 지원하는 다른 AI 코딩 에이전트의 경우 프로젝트 디렉터리에서 다음 명령어를 실행합니다.

npx skills add google/skills/skills/analytics

Google 애널리틱스 AI 에이전트 기술 업데이트

다음 명령어를 실행하여 사용 가능한 업데이트를 다운로드하고 오래된 기술을 정리합니다.

npx skills update --all

Google 애널리틱스 AI 에이전트 기술 사용

AI 코딩 에이전트는 스킬 설명이 프롬프트와 일치하는 것을 감지하면 스킬을 자동으로 로드합니다. 전역적으로 설치된 기술은 요청에 Google 애널리틱스 작업이 포함되지 않는 한 관련 없는 프로젝트에서 비활성 상태로 유지됩니다.

지원되는 AI 코딩 에이전트에서 스킬을 수동으로 호출하려면 채팅 입력에 / 문자를 입력하고 이름으로 스킬을 선택합니다.

스킬의 핵심 구성요소

각 Google 애널리틱스 AI 에이전트 스킬은 AI 코딩 에이전트에 다음 구성요소를 제공합니다.

  • 특수 안내: gcloud CLI를 사용하여 Google 애널리틱스 API를 사용 설정하고, 애플리케이션 기본 사용자 인증 정보(ADC)를 구성하고, runReport 쿼리를 빌드하고, 필드 호환성을 확인하는 단계별 안내입니다.
  • 권장사항: 권장 API 버전 선택(일반적인 안정성을 위한 v1beta 엔드포인트 및 사전 체험판 Admin API 기능을 위한 v1alpha 엔드포인트), 강력한 유형의 요청 구성, 스키마 검증 워크플로
  • 참고 문서: 각 기술의 references/ 디렉터리에 있는 Python, Java, Node.js, PHP, Go, .NET, Ruby용 언어별 클라이언트 라이브러리 설치 가이드 및 코드 샘플

AI 에이전트 스킬의 이점

AI 에이전트 스킬은 모든 대화에 대규모 문서 세트를 로드하지 않고도 필요에 따라 전문적인 Google 애널리틱스 지식으로 AI 코딩 에이전트를 확장합니다.

토큰 비용 절감

전체 API 참고 문서를 미리 로드하면 컨텍스트 토큰이 소비되고 세션 비용이 증가합니다. AI 에이전트 스킬은 단계적 공개를 사용하여 컨텍스트 사용을 최소화합니다.

  • 시작 시 AI 코딩 에이전트는 각 스킬의 이름과 간단한 설명만 읽어 스킬이 프롬프트와 일치하는지 확인합니다.
  • 에이전트는 작업에 필요한 경우에만 전체 SKILL.md 안내와 언어별 참조 파일을 활성 컨텍스트 윈도우에 로드합니다.

AI 기반 구현

자연어로 목표를 설명하면 설치된 스킬이 다음과 같은 Google 애널리틱스 구현 작업을 통해 AI 코딩 에이전트를 안내합니다.

  • 프로젝트에서 Google Analytics Data API를 사용 설정하고 city 및 date 측정기준으로 activeUsers 및 sessions 측정항목을 쿼리하는 Python 스크립트를 작성합니다.
  • checkCompatibility 메서드를 사용하여 itemName 측정기준이 Google 애널리틱스 속성의 activeUsers 및 totalRevenue 측정항목과 호환되는지 확인합니다.
  • Google Analytics Admin API를 사용하여 Node.js에서 액세스 가능한 모든 Google 애널리틱스 계정 요약 및 하위 속성을 나열합니다.
  • Google 애널리틱스 속성의 맞춤 측정기준, 데이터 스트림, 측정 프로토콜 보안 비밀을 구성합니다.

Google 애널리틱스 MCP 서버와 함께 스킬 사용

Google 애널리틱스 AI 에이전트 스킬은 Google 애널리틱스 모델 컨텍스트 프로토콜(MCP) 서버를 보완합니다.

  • Google 애널리틱스 MCP 서버: AI 코딩 에이전트를 실시간 Google 애널리틱스 속성에 직접 연결하여 에이전트가 계정 요약, 속성 세부정보, 맞춤 측정기준, 맞춤 측정항목, 실시간 보고서를 검사할 수 있습니다.
  • Google 애널리틱스 AI 에이전트 기술: API를 사용 설정하고, ADC 인증을 구성하고, 필드 호환성을 확인하고, 애플리케이션 코드를 작성할 때 AI 코딩 에이전트를 안내하는 토큰 효율적인 안내와 클라이언트 라이브러리 참조를 제공합니다.

사용 가능한 기술

Google은 google/skills 저장소에서 다음 Google 애널리틱스 AI 에이전트 기술을 유지관리합니다.

기술 설명
google-analytics-data-api-basics gcloud CLI를 사용하여 Google Analytics Data API(analyticsdata.googleapis.com)를 사용 설정하고, analytics.readonly OAuth 2.0 범위로 ADC를 구성하고, 공식 v1beta 클라이언트 라이브러리(Python, Java, PHP, Node.js, Go, .NET, Ruby)를 설치합니다. 에이전트가 runReport 쿼리를 빌드하고 getMetadata 및 checkCompatibility 메서드와의 필드 호환성을 확인하도록 안내합니다.
google-analytics-admin-api-basics gcloud CLI를 사용하여 Google Analytics Admin API(analyticsadmin.googleapis.com)를 사용 설정하고, analytics.readonly 및 analytics.edit OAuth 2.0 범위로 ADC를 구성하고, 공식 v1beta 및 v1alpha 클라이언트 라이브러리(Python, Java, PHP, Node.js, Go, .NET, Ruby)를 설치합니다. 상담사가 계정 요약을 나열하고 속성, 데이터 스트림, 맞춤 측정기준, 맞춤 측정항목, 주요 이벤트, 측정 프로토콜 보안 비밀, 제품 연결을 관리하도록 안내합니다.

다음 단계