콘텐츠로 이동
✍️ 수정가능누구나 고쳐도 됩니다. 고치면 하단 frontmatter의 갱신일·작성자·변경요약을 남겨 주세요.작성 Claude · 2026-06-04 · v12 재편·raw 컴파일·인간화

GA 트래킹 파이프라인

요지

MS2(MVP-B) 기능. Google Analytics(GA4) 기반 이벤트 트래킹 파이프라인 — 사용자 행동 데이터 수집의 공통 아키텍처·명명 규칙·유틸리티를 정의한다. 개별 기능의 상세 이벤트 스키마는 각 기능 FDD에서 정의한다.

해결하는 문제

사용자 행동 데이터가 수집되지 않아 퍼널·기능 사용성을 정량 판단할 근거가 없었다. GA4 기반 공통 트래킹 파이프라인을 구축해 일관된 이벤트 명명·환경 분리·유틸리티를 표준화하고, 각 기능이 그 위에 이벤트를 얹는다. 마케팅·기획은 GA4에서 퍼널(가입→스터디룸 생성→수업노트 작성)·이탈 지점을 분석할 수 있게 된다.

핵심 동작

사용자 → 브라우저(Next.js) → lib/gtag.ts(sendEvent) → Google Analytics
         (비즈니스 로직은 별도로 Spring Boot API 호출 — 두 경로는 교차하지 않음)
  • 아키텍처: 이벤트는 Next.js 클라이언트 → GA 서버로 직접 전송. Spring 백엔드는 비즈니스 API만 담당(파이프라인 무관).
  • 환경 분리: NEXT_PUBLIC_GA_MEASUREMENT_ID로 dev/prod Measurement ID 분리(값은 환경변수).
  • 명명 규칙: [domain]_[action] 또는 [domain]_[object]_[action] (예: login_click, studyroom_studynote_click).
  • 공통 파라미터: user_type(teacher/student/guardian/null).
  • page_view: 라우트 변경 시 자동 전송.
  • 안정성: 트래킹 오류·네트워크 실패가 UX에 영향 X(콘솔 경고 수준).

상세 아키텍처·유틸·명명 규칙·화면별 이벤트 표는 frd, 태깅 매핑은 design.

관련