연결 안내
AI 앱에 AskGA를 연결하는 방법과, 연결이 잘 되지 않을 때 확인할 점을 안내합니다.
시작하기 전에 준비할 것
- 이메일 인증을 마친 AskGA 계정
- 연결할 GA4 속성을 볼 수 있는 Google 계정
- 원격 MCP 서버(커넥터)를 추가할 수 있는 AI 앱. 지원 범위는 앱과 요금제마다 다르므로 각 앱의 도움말을 확인하세요.
연결 순서
- AskGA에 가입하고, 인증 메일의 링크를 눌러 이메일 인증을 마칩니다.
- 연결 화면에서 Google 계정을 추가하고, 쓸 GA4 속성을 연결해 켭니다.
- AI 앱의 커넥터(MCP 서버) 추가 화면에 아래 주소를 넣습니다.
- AskGA 로그인과 접근 허용 화면이 이어지면 로그인하고 허용을 누릅니다. 그다음 대화창에서 GA4 데이터를 물어보세요.
AI 앱의 커넥터(MCP 서버) 추가 화면에 아래 주소를 넣으세요. AskGA 로그인과 접근 허용 화면이 이어집니다.
예: Claude에서는 맞춤 커넥터로 추가합니다.
제공하는 도구
모든 도구는 GA4 데이터를 읽기만 합니다. AI가 질문에 맞는 도구를 골라 호출합니다.
list_properties- AskGA에 연결한 GA4 속성과 그 시간대·통화를 보여 줍니다.
get_metadata- 속성에서 쓸 수 있는 측정기준·측정항목과 맞춤 정의를 찾아봅니다.
run_report- 기간·측정기준·측정항목·필터를 지정해 GA4 보고서를 조회합니다. 상대 날짜는 속성 시간대 기준의 날짜로 바꿔 알려 줍니다.
run_realtime_report- GA4 실시간 보고서로 지금 활동 중인 사용자와 이벤트를 조회합니다.
예시 질문
대화창에서 이렇게 물어보세요.
- 내 AskGA 계정에 연결된 GA4 속성을 알려줘.
- 지난 28일 동안 기본 채널 그룹별 세션 수와 활성 사용자 수를 보여줘.
- 이번 달 세션 기준 상위 10개 방문 페이지를 지난달과 비교해 줘.
- 지금 내 사이트에 있는 사용자 수를 국가별로 알려줘.
문제 해결
도구 호출이 실패하면 AskGA가 오류 코드를 함께 돌려주고, AI 앱이 그 코드를 보여 줍니다. 코드별로 아래 내용을 확인하세요.
- 오류 코드:
PROPERTY_NOT_CONNECTED - 해결 방법:연결 화면에서 그 GA4 속성을 연결하고 켭니다.
- 오류 코드:
ACCESS_INACTIVE - 해결 방법:연결 화면에서 속성이 켜져 있는지 확인하고, 결제 화면에서 구독이나 무료 체험이 유효한지 확인합니다.
- 오류 코드:
GOOGLE_REAUTH_REQUIRED - 해결 방법:연결 화면에서 그 Google 계정을 다시 연결합니다.
- 오류 코드:
GA_PERMISSION_DENIED - 해결 방법:GA4에서 그 Google 계정에 속성 읽기 권한이 있는지 확인한 뒤, 연결 화면에서 다시 연결합니다.
- 오류 코드:
GA_QUOTA_EXHAUSTED - 해결 방법:GA4 API 할당량을 다 썼습니다. 잠시 뒤 다시 시도하거나, 조회 기간과 측정기준을 줄여 보세요.
- 오류 코드:
INVALID_ARGUMENT - 해결 방법:AI에게 측정기준과 측정항목 이름을 먼저 확인한 뒤 다시 조회해 달라고 요청하세요.
- 오류 코드:
UPSTREAM_UNAVAILABLE - 해결 방법:Google Analytics가 제시간에 응답하지 않았습니다. 잠시 뒤 다시 시도하세요.
로그인을 계속 요구하거나 연결이 끊어졌나요?
이메일 인증을 마쳤는지 먼저 확인하세요. 그래도 같으면 연결 화면의 「연결된 AI 앱」에서 그 앱의 연결을 해제한 뒤, AI 앱에서 커넥터를 다시 추가하세요.
데이터 처리
- Google에는 GA4 읽기 권한(analytics.readonly)만 요청합니다. AskGA는 GA4 설정과 데이터를 바꾸지 않습니다.
- AI가 요청한 보고서를 조회해 그대로 전달할 뿐, 조회 내용과 결과를 저장하지 않습니다.
- Google 연결 정보는 암호화해 보관하고, 연결을 해제하거나 탈퇴하면 Google에 권한 회수를 요청한 뒤 지웁니다.
- AI 앱에 준 접근 권한은 연결 화면에서 언제든 해제할 수 있습니다.
문의
연결이 되지 않거나 궁금한 점이 있으면 support@askga.app로 문의해 주세요.