Skip to content

[Feature] GA4 분석 연동 #417

Description

@jyt6640

🔥PURPOSE

GA4로 yANUs Groupware의 실제 페이지 사용 흐름을 측정합니다.

📌DETAIL

  • Google tag Measurement ID: G-JGZ8JFGKPW
  • React Router 기반 SPA이므로 라우트 이동마다 중복 없이 page_view를 전송합니다.
  • Measurement ID는 코드에 하드코딩하지 않고 VITE_GA_MEASUREMENT_ID 환경변수로 주입합니다.
  • 기존 API, 인증, 권한, Vercel Analytics 동작은 변경하지 않습니다.
  • 개인정보나 입력값·토큰은 이벤트 파라미터로 전송하지 않습니다.

📒TODO

  • GA4 Measurement ID 환경변수와 로컬 예시 문서화
  • gtag.js 로더와 타입 안전한 page_view 전송 모듈 추가
  • React Router 경로 변경 추적 연결
  • ID 미설정 시 외부 스크립트가 로드되지 않는 테스트 추가
  • 테스트, build, lint, 브라우저 smoke 검증
  • develop PR 생성 후 기존 main release PR 반영 상태 확인

✅완료 조건

  • 배포 환경의 VITE_GA_MEASUREMENT_ID로 Google tag가 로드된다.
  • 초기 진입과 SPA 라우트 이동마다 GA4 page_view가 한 번씩 전송된다.
  • ID가 없으면 analytics 요청이나 오류 없이 앱이 동작한다.
  • 사용자 입력값·토큰·API 응답 데이터가 GA4에 전달되지 않는다.
  • CI와 로컬 검증을 통과한다.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions