Skip to content

release: v1.1.8 - #419

Open
jyt6640 wants to merge 5 commits into
mainfrom
develop
Open

release: v1.1.8#419
jyt6640 wants to merge 5 commits into
mainfrom
develop

Conversation

@jyt6640

@jyt6640 jyt6640 commented Aug 22, 2026

Copy link
Copy Markdown
Member

작업 내용

  • develop에 반영된 GA4 분석 연동을 production release 대상으로 제안합니다.
  • 릴리스 버전: v1.1.8
  • 포함 변경: [Feature] GA4 분석 연동 #417 GA4 Google tag 및 SPA page_view 추적

변경 이유

  • yANUs Groupware의 인증 화면과 업무 화면 이동을 GA4에서 측정할 수 있도록 합니다.
  • React Router 경로 변경을 중복 없이 추적하고, 사용자 입력·토큰·API 응답은 전송하지 않습니다.

상세 변경 사항

  • VITE_GA_MEASUREMENT_ID 기반 Google tag 지연 로드
  • 초기 진입과 SPA 라우트 이동 page_view 전송
  • 동일 경로 중복 전송 방지
  • Measurement ID 미설정 시 무동작 fallback
  • GA4 parser/client/route tracker 테스트 추가
  • develop PR [Feat] #417 - GA4 분석 연동 #418 CI와 Vercel Preview 통과
  • Vercel Production/Preview 환경변수 VITE_GA_MEASUREMENT_ID 등록

테스트

  • npm run test:run: 64개 파일, 463개 테스트 통과
  • clean TypeScript build 및 Vite build 통과
  • 변경 파일 lint 통과
  • Chromium에서 Measurement ID 주입 후 GA script 1개와 /login → /register page_view 2건 확인
  • 전체 lint: 기존 baseline 오류 24개와 경고 4개

리뷰 포인트

  • Google tag의 send_page_view: false와 수동 SPA 추적의 중복 방지
  • StrictMode에서 초기 page_view dedupe
  • 배포 환경변수 등록 후 GA4 Realtime 또는 Tag Assistant 검증
  • main 반영 이후 Production에서 실제 데이터 수집 여부

관련 이슈

Vercel CLI 인증 토큰이 만료되어 환경변수 자동 등록은 별도 설정이 필요합니다. main merge는 저장소 관리자 승인 후 진행합니다.

- Measurement ID 파싱과 script/dataLayer 동작 검증\n- SPA 라우트 이동별 page_view 중복 방지 검증
- 환경변수 기반으로 Google tag를 지연 로드하고 초기 자동 page_view를 비활성화\n- React Router 경로 변경마다 개인정보 없이 page_view를 전송
- Vercel과 로컬 환경에서 사용할 Measurement ID 변수 추가\n- Google Analytics 4 설정 위치를 README에 기록
- GoogleAnalyticsCommand union을 tuple index assertion으로 검증\n- CI의 fresh TypeScript build에서도 테스트 타입을 통과하도록 정리
GA4 Google tag와 SPA page_view 추적을 develop에 반영
@vercel

vercel Bot commented Aug 22, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
yanus-groupware Ready Ready Preview Aug 22, 2026 3:28am

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant