Google Analytics
GA4 속성의 리포트를 조회합니다.
Google 쪽 준비
- Google Cloud 프로젝트의 API 라이브러리에서 Google Analytics Data API와 Google Analytics Admin API를 사용 설정합니다. 결제 계정은 필요 없습니다.
- 같은 프로젝트에서 서비스 계정을 만들고 키 → 키 추가 → JSON으로 키 파일을 내려받습니다. Google Cloud 역할은 주지 않아도 됩니다.
- Google Analytics 관리 → 속성 액세스 관리에서 서비스 계정 이메일을 뷰어로 추가합니다. 계정 액세스 관리에서 추가하면 그 계정의 모든 GA4 속성이 목록에 나타납니다.
유니버설 애널리틱스 속성은 지원하지 않습니다.
연결 설정
키 파일을 선택하면 서비스 계정이 볼 수 있는 GA4 속성 목록이 나타납니다. 속성을 최대 50개까지 고르고 저장합니다. 저장할 때 Gate가 속성마다 실제 접근을 확인합니다. 별도의 테이블 선택 단계는 없습니다.
조회 범위
AI는 SQL 대신 리포트 요청을 보냅니다.
| 항목 | 범위 |
|---|---|
| 지표 | 1~10개 |
| 차원 | 최대 9개 |
| 날짜 범위 | 1~4개. YYYY-MM-DD, today, yesterday, 7daysAgo 형식 |
| 필터 | 차원·지표 필터를 AND로 결합. 문자열, 목록, 숫자, 범위, 빈 값 |
| 정렬 | 요청한 차원·지표만 |
집계는 GA4가 속성 전체 데이터로 계산합니다. 반환 행 수를 줄여도 GA4 할당량 소비는 크게 줄지 않습니다.
필드 설명
GA4 표준 차원·지표는 Google이 정의를 정하므로 스키마 메뉴에서 읽기 전용 사전으로 보여 줍니다. 전환으로 보는 이벤트, 채널 묶음, 매출 지표, 커스텀 차원의 뜻 같은 업무 해석은 시맨틱에 적습니다.
잘 안 될 때
| 증상 | 확인할 것 |
|---|---|
| 속성 목록을 가져올 수 없음 | Admin API를 켰는지, 서비스 계정에 GA 권한이 있는지 확인합니다. 켠 직후엔 몇 분 걸립니다. |
| 접근할 수 있는 속성이 없음 | GA에 추가한 이메일과 키 파일의 서비스 계정 이메일이 같은지 확인합니다. |
| 저장할 때 연결 실패 | Data API를 켰는지, 그 속성에 권한이 있는지 확인합니다. |
| 조회할 때 할당량 오류 | GA4 Data API는 속성별 하루 토큰 한도가 있습니다. 표준 속성은 하루 25,000입니다. |