Story: GA4 이벤트 연동

메타

항목	값
Story ID	E-11-S-03
Epic	E-11 온보딩 팝업
상태	ready-for-dev
우선순위	P0
규모	S
담당 개발자	수민 (FE)

---

사용자 스토리

As a PO,
I want 온보딩 팝업의 효과를 측정하고 싶다,
So that 연동 전환율 개선 여부를 검증할 수 있다.

---

수락 기준 (Acceptance Criteria)

AC-01: 팝업 노출 이벤트

항목	내용
Given	온보딩 팝업이 노출될 때
When	팝업 컴포넌트가 마운트되면
Then	view_onboarding_popup 이벤트가 전송된다

// GA4 이벤트
gtag('event', 'view_onboarding_popup', {
  user_id: string,
  source: 'signup' | 'login'
});

AC-02: 연동하기 클릭 이벤트

항목	내용
Given	팝업이 노출된 상태에서
When	"연동하기" 버튼을 클릭하면
Then	click_onboarding_connect 이벤트가 전송된다

// GA4 이벤트
gtag('event', 'click_onboarding_connect', {
  user_id: string
});

AC-03: 나중에 클릭 이벤트

항목	내용
Given	팝업이 노출된 상태에서
When	"나중에 할게요"를 클릭하면
Then	click_onboarding_later 이벤트가 전송된다

// GA4 이벤트
gtag('event', 'click_onboarding_later', {
  user_id: string
});

---

태스크 분해

Task 1: 이벤트 유틸 함수 AC-01, AC-02, AC-03

• [ ] 1.1: trackOnboardingPopupView() 함수 생성
• [ ] 1.2: trackOnboardingConnect() 함수 생성
• [ ] 1.3: trackOnboardingLater() 함수 생성

Task 2: 팝업 컴포넌트 연동

• [ ] 2.1: 팝업 마운트 시 view 이벤트 호출
• [ ] 2.2: "연동하기" 버튼에 connect 이벤트 연결
• [ ] 2.3: "나중에" 버튼에 later 이벤트 연결

Task 3: 테스트

• [ ] 3.1: GA4 DebugView에서 이벤트 전송 확인
• [ ] 3.2: 파라미터 값 정상 전송 확인

---

Dev Notes

의존성

• E-11-S-01 (OnboardingPopup 컴포넌트) 완료 필요

GA4 이벤트 정의

이벤트명	트리거	파라미터
view_onboarding_popup	팝업 노출	user_id, source
click_onboarding_connect	"연동하기" 클릭	user_id
click_onboarding_later	"나중에" 클릭	user_id

측정 지표

팝업 → 연동 시작 전환율 = click_onboarding_connect / view_onboarding_popup

Target: 30%+

---

생성일: 2026-01-23