이용약관과 개인정보처리방침을 개정했습니다(2026-12-22 시행). 이용약관개인정보처리방침

연결 안내

AI 앱에 AskGA를 연결하는 방법과, 연결이 잘 되지 않을 때 확인할 점을 안내합니다.

시작하기 전에 준비할 것

  • 이메일 인증을 마친 AskGA 계정
  • 연결할 GA4 속성을 볼 수 있는 Google 계정
  • 원격 MCP 서버(커넥터)를 추가할 수 있는 AI 앱. 지원 범위는 앱과 요금제마다 다르므로 각 앱의 도움말을 확인하세요.

연결 순서

  1. AskGA에 가입하고, 인증 메일의 링크를 눌러 이메일 인증을 마칩니다.
  2. 연결 화면에서 Google 계정을 추가하고, 쓸 GA4 속성을 연결해 켭니다.
  3. AI 앱의 커넥터(MCP 서버) 추가 화면에 아래 주소를 넣습니다.
  4. 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로 문의해 주세요.