GA 분석 리포트 가이드

조직의 GA4+Search Console 통합 AI 분석 리포트(핵심)와, 선택한 속성/사이트의 최신 지표·이력(보조)을 함께 조회합니다.

🔗 GA 분석 리포트 열기 →

📋 개요

이 페이지는 두 계층으로 구성됩니다.

• 종합 리포트(핵심) — GA4+Search Console 데이터를 함께 본 AI 분석. 우측 이력 리스트에서 지난 날짜를 클릭하면 그 시점 리포트를 다시 볼 수 있고, 마음에 드는 제안은 "이 제안을 이슈로 등록" 버튼으로 바로 giip 이슈로 등록할 수 있습니다.
• 개별 GA4 / GSC 패널(보조) — 종합 리포트 아래에 속성별 최신 지표(KPI 카드)와 최근 일별 이력 테이블, GSC 상위 검색어를 각각 별도 패널로 보여줍니다. 개별 AI 분석은 더 이상 여기서 생성되지 않으며(위 종합 리포트가 유일한 최종 분석), 이 패널들은 숫자를 직접 확인하고 싶을 때 참고용으로만 씁니다.

✅ 전제 조건

1. GA4 속성과(선택) Search Console 사이트가 조직에 등록되어 있어야 함 — GA 속성 관리, GSC 사이트 참고. 종합 리포트는 등록되지 않은 소스가 있으면 그 항목을 "설정 필요" 링크로 안내합니다.
2. 수집이 동작 중이어서 데이터가 있어야 함(아래 "수집 설정" 참고).

🔎 리포트 조회

1. 페이지에 들어가면 종합 리포트가 자동으로 로드됩니다. 우측 이력 리스트에서 날짜를 클릭하면 해당 시점 리포트로 전환되고, "최신으로" 버튼으로 다시 최신 리포트로 돌아올 수 있습니다.
2. 개별 지표를 보고 싶으면 아래 GA4/GSC 패널에서 등록된 속성·사이트를 드롭다운으로 선택(또는 수동 입력)하세요.

📊 지표

지표	의미
활성 사용자	순 활성 사용자
세션	세션 수
페이지뷰	화면/페이지 조회수
이탈률	단일 상호작용 세션 비율(% 표시)
전환수	전환 이벤트
평균 세션(초)	평균 세션 시간(초)
클릭수 / 노출수 (GSC)	Search Console 검색 결과 클릭·노출
CTR / 평균 순위 (GSC)	클릭률(%) / 평균 검색 순위

🤖 AI 분석은 어떻게 페이지를 구분하나

종합 리포트의 AI는 사이트의 각 경로(URL)를 보고 마케팅/공개 페이지(방문자가 로그인 없이 보는 랜딩·블로그 등)와 로그인 후 제품/관리 화면(예: 대시보드, 관리자 전용 화면)을 자동으로 구분해서 분석합니다. 후자는 "전환 유입" 관점의 지적 대상에서 자동으로 빠집니다.

자동 분류가 우리 조직 상황과 다르거나(예: 일부 공개 페이지를 예외적으로 로그인 없이 운영), 우리 서비스만의 방향성·타겟 고객을 AI가 더 잘 반영하게 하고 싶다면 **관리자 > Gareport AI 커스텀 프롬프트**에서 우리 조직(csn)에만 적용되는 추가 지침을 직접 입력할 수 있습니다. 전역 규칙을 대체하지 않고 그 뒤에 덧붙는 방식입니다.

⚙️ 수집 설정 (관리자)

지표는 GIIP 에이전트/서버가 수집하고 정기적으로 AI가 통합 분석합니다. 최초 설정:

1. GA4 속성 등록(GA 속성 관리) 및 GSC 사이트 등록(GSC 사이트) — 두 소스를 모두 등록해야 종합 리포트가 완전해집니다.
2. 서비스계정 키 — GA4 읽기 권한의 Google 서비스계정을 만들어 속성에 공유. 키 JSON은 giipdb mgmt/ga-collector.config.json.sample의 serviceAccountKeyFile 경로에 배치(실제 경로: giipdb/.secrets/ga-service-account.json, gitignore). giipfaw의 ProcessGaCollect가 이 파일을 읽어 Google Data API를 직접 호출합니다.
3. 수집 잡 — giipfaw의 타이머 함수(ProcessGaCollect)가 DB(tGaConfig)에 등록된 활성 속성 목록을 읽고 자동으로 수집을 실행합니다. 별도 PC/에이전트 배포가 필요하지 않습니다. CQE 가이드 및 giipdb docs/30_Specs/CQE_SPECIFICATION.md는 기존 에이전트 기반 수집 설정에만 적용됩니다(구방식).
4. AI 분석(종합) — giipfaw의 ProcessComboReport가 GA4+GSC 데이터를 함께 읽어 통합 리포트를 생성합니다. 표본이 너무 적으면(예: 방문자 수 부족) 그 사실을 리포트에 함께 표시합니다.

수집이 돌기 시작하면 이 페이지가 자동으로 채워집니다.

문제 해결

증상	원인	해결
"아직 리포트가 없습니다"	종합 리포트 배치가 아직 실행되지 않음	수집·설정 여부를 확인하고 다음 실행을 기다리세요.
"설정 필요" 링크가 뜸	GA4 속성 또는 GSC 사이트 중 하나가 미등록	안내된 링크(GA 속성 관리 / GSC 사이트)에서 등록.
속성/사이트 드롭다운이 비어 있음	이 조직에 등록된 속성·사이트 없음	각 관리 화면에서 등록.
403 / 접근 거부	속성 조직에 대한 권한 없음	소속 조직으로 사용.
AI 분석이 우리 서비스 구조를 잘못 이해함	자동 페이지 분류가 우리 조직의 예외 상황을 반영 못함	Gareport AI 커스텀 프롬프트에서 추가 지침 입력.

---

버전: 1.2 최종 업데이트: 2026-08-16 소스 파일: giipv3/public/help/gareport.ko.md