feat(analytics): Google Analytics 연동 및 Rakuten Affiliate 승인용 일일 방문량 제공

[CIOI]

배경

Rakuten Affiliate 프로그램 승인을 받기 위해, 사이트 트래픽(일일 방문량)을 제출할 수 있어야 합니다. 이를 위해 Google Analytics(GA4)를 decoded 웹에 연결하고, 승인 심사·운영에 필요한 방문 지표를 확인·제공할 수 있는 상태를 만듭니다.

목표

• decoded 프로덕션(및 필요 시 스테이징) 도메인에 Google Analytics 4 스니펫/태그 연동
• 일일 방문자 수(또는 Rakuten이 요구하는 동등 지표)를 GA 대시보드에서 확인 가능
• Affiliate 승인 신청 시 스크린샷 또는 리포트로 제출할 수 있는 절차 정리(담당자·주기)

범위(제안)

1. GA4 프로퍼티·측정 ID

• Google Analytics 계정/프로퍼티 생성(또는 기존 프로퍼티 사용)
• GA4 Measurement ID (G-XXXXXXXX) 확보 및 시크릿/환경변수 관리 방침 결정

2. 웹 앱 연동 (packages/web)

• Next.js App Router에 맞는 GA4 로딩 방식 적용(예: next/script, 공식 gtag, 또는 @next/third-parties/google)
• 프로덕션에서만 로드 vs 개발 환경 제외 정책
• 페이지뷰·필요 시 라우트 변경 추적(클라이언트 네비게이션)

3. 개인정보·동의

• 쿠키/트래킹 동의 배너와 GA 로드 시점 정합성(해당 지역·정책에 맞게)
• 개인정보 처리방침에 Analytics 사용 명시 여부 검토

4. Rakuten Affiliate 승인용 운영

• GA4 Reports → Engagement / Traffic 등에서 일일 Active users / Sessions 확인 방법 문서화
• 승인 담당자가 주기적으로 캡처·제출할 체크리스트(날짜 범위, 지표 이름)

비범위(초기)

• 커스텀 이벤트·전자상거래 전체 퍼널(affiliate 클릭은 기존 useAffiliateClick 등과 별도 검토)
• GA Data API로 자동 리포트 메일링(필요 시 후속 이슈)

수용 기준

1. 프로덕션 URL 방문 시 GA4 Realtime 또는 DebugView에서 히트가 보인다.
2. 최소 1일치 이상 일일 방문(또는 active users) 지표를 GA UI에서 확인할 수 있다.
3. Rakuten Affiliate 신청에 필요한 일일 방문량 증빙 방법(스크린샷 가이드 또는 내부 wiki 1페이지)이 있다.

참고

• 기존 affiliate 클릭 추적: packages/web/lib/hooks/useAffiliateClick.ts, SpotSolutionTabs 등
• Commerce/affiliate 로드맵: specs/_next/NEXT-04-commerce-bridge.md

라벨 제안

enhancement, analytics, affiliate, packages/web