GA 분석 리포트 가이드
선택한 속성의 최신 GA4 지표, 일1회 AI 분석, 최근 이력을 조회합니다.
📋 개요
선택한 GA4 속성에 대해 다음을 표시합니다.
- 최신 지표 — 가장 최근 수집 스냅샷(KPI 카드).
- AI 분석 — 일1회 생성되는 요약·이상탐지·권고.
- 최근 이력 — 최근 일별 스냅샷 테이블.
✅ 전제 조건
- 속성이 조직에 등록되어 있어야 함 — GA 속성 관리 참고.
- 수집이 동작 중이어서 데이터가 있어야 함(아래 "수집 설정" 참고).
🔎 리포트 조회
- 조직에 등록된 속성이 있으면 GA 속성 드롭다운에서 선택, 없으면 수동 입력란에
properties/<id>를 넣고 조회. - 최신 지표·최신 AI 분석·최근 이력이 로드됩니다.
📊 지표
| 지표 | 의미 |
|---|---|
| 활성 사용자 | 순 활성 사용자 |
| 세션 | 세션 수 |
| 페이지뷰 | 화면/페이지 조회수 |
| 이탈률 | 단일 상호작용 세션 비율(% 표시) |
| 전환수 | 전환 이벤트 |
| 평균 세션(초) | 평균 세션 시간(초) |
⚙️ 수집 설정 (관리자)
지표는 GIIP 에이전트가 수집하고 하루 1회 분석합니다. 최초 설정:
- 속성 등록(GA 속성 관리).
- 서비스계정 키 — GA4 읽기 권한의 Google 서비스계정을 만들어 속성에 공유하고, 키 JSON을 수집 PC에 배치. 템플릿: giipdb
mgmt/ga-service-account.json.sample. - 수집 잡 — giipdb
mgmt/register-ga-cqe.ps1로 CQE를 통해 수집기(ga-collect.cqe.ps1)를 PC에 배달. CQE 가이드 및 giipdbdocs/30_Specs/CQE_SPECIFICATION.md참고. - AI 분석 — 일1회 배치(
execgiipga.sh)가 AI 리포트를 생성.tGaConfig(queue_sk)시드와 AI API 키 필요.
수집이 돌기 시작하면 이 페이지가 자동으로 채워집니다.
문제 해결
| 증상 | 원인 | 해결 |
|---|---|---|
| "GA 데이터가 없습니다" | 이 속성에 아직 수집분 없음 | 수집 설정 여부와 에이전트가 1회 이상 실행됐는지 확인. |
| 속성 드롭다운이 비어 있음 | 이 조직에 등록된 속성 없음 | GA 속성 관리에서 등록. |
| "아직 AI 분석 결과가 없습니다" | 일1회 AI 배치 결과 없음 | 다음 실행을 기다리거나 배치/tGaConfig 확인. |
| 403 / 접근 거부 | 속성 조직에 대한 권한 없음 | 소속 조직으로 사용. |
버전: 1.0
최종 업데이트: 2026-07-23
소스 파일: giipv3/public/help/gareport.ko.md