테마
Story: 바이럴 퍼널 대시보드 (어드민)
메타
| 항목 | 값 |
|---|---|
| Story ID | E-07-S-14 |
| Epic | E-07 쿠폰 & 추천인 코드 |
| 상태 | ready-for-dev |
| 우선순위 | P2 |
| 규모 | M |
| 담당 개발자 | FE, BE |
사용자 스토리
As a 운영팀,
I want 바이럴 퍼널을 실시간으로 모니터링하고 싶다,
So that 추천 시스템의 효과를 측정하고 개선할 수 있다.
수락 기준 (Acceptance Criteria)
AC-01: 퍼널 전환율 표시
| 항목 | 내용 |
|---|---|
| Given | 어드민 바이럴 대시보드에서 |
| When | 퍼널을 조회하면 |
| Then | 공유→가입→몰연동→결제 각 단계 전환율이 표시된다 |
AC-02: 바이럴 계수 K
| 항목 | 내용 |
|---|---|
| Given | 대시보드 상단에 |
| When | 핵심 지표를 확인하면 |
| Then | 바이럴 계수 K와 트렌드가 표시된다 |
AC-03: 기간별 필터
| 항목 | 내용 |
|---|---|
| Given | 대시보드에서 |
| When | 기간 필터를 변경하면 |
| Then | 해당 기간의 데이터로 갱신된다 |
AC-04: 상위 추천인 목록
| 항목 | 내용 |
|---|---|
| Given | 대시보드 하단에 |
| When | 상위 추천인 목록을 확인하면 |
| Then | 추천 수 기준 Top 10이 표시된다 |
태스크 분해
Task 1: 퍼널 시각화
- [ ] 1.1: /admin/viral 라우트 생성
- [ ] 1.2: 퍼널 차트 컴포넌트
- 유료 유저 → 공유 → 가입 → 몰연동 → 결제
- 각 단계별 수치 + 전환율
- [ ] 1.3: 퍼널 API
- GET /admin/viral/funnel?from=&to=
Task 2: 핵심 지표
- [ ] 2.1: 바이럴 계수 K 계산
- K = 신규유료/기존유료 (추천 기준)
- [ ] 2.2: KPI 카드
- 추천 가입 비율, 추천 결제 전환율
- 총 발급 크레딧, 평균 크레딧/유저
- [ ] 2.3: 트렌드 표시 (전주 대비)
Task 3: 상세 분석
- [ ] 3.1: 기간별 필터 (7일/30일/90일/전체)
- [ ] 3.2: 상위 추천인 목록
- 추천 수, 활성화 수, 결제 수, 적립 크레딧
- [ ] 3.3: 크레딧 현황
- 총 발급, 총 사용, 총 만료, 미사용 잔액
화면 설계
┌────────────────────────────────────────────────────────────┐
│ 바이럴 퍼널 대시보드 [7일] [30일] [90일] │
├────────────────────────────────────────────────────────────┤
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 바이럴 K │ │추천 가입율│ │추천 결제율│ │ 총 크레딧 │ │
│ │ 0.15 │ │ 18% │ │ 52% │ │ 420만원 │ │
│ │ ↑+0.03 │ │ ↓-2% │ │ ↑+5% │ │ ↑+80만 │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ │
│ ───────────────────────────────────────────── │
│ │
│ 📊 바이럴 퍼널 │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 유료 유저 (50명) │ │
│ │ ════════════════════════════════════════════════ │ │
│ │ ↓ 공유율 30% │ │
│ │ 공유 (15명) │ │
│ │ ════════════════════════════ │ │
│ │ ↓ 가입전환 20% │ │
│ │ 추천 가입 (3명) │ │
│ │ ════════════ │ │
│ │ ↓ 몰연동 60% │ │
│ │ 몰연동 (2명) │ │
│ │ ══════ │ │
│ │ ↓ 결제 50% │ │
│ │ 결제 (1명) │ │
│ │ ═══ │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ ───────────────────────────────────────────── │
│ │
│ 🏆 상위 추천인 │
│ │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ 순위 이름 추천 활성 결제 크레딧 │ │
│ ├─────────────────────────────────────────────────────┤ │
│ │ 1 김셀러 12 8 5 35,000원 │ │
│ │ 2 이판매 8 6 4 28,000원 │ │
│ │ 3 박상인 5 3 2 14,000원 │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
└────────────────────────────────────────────────────────────┘개발 노트
바이럴 계수 K 계산
K = (추천으로 인한 신규 유료 유저 수) / (기존 유료 유저 수)
목표: K > 1 (자가 성장)
현실적 목표: K > 0.3 (의미 있는 바이럴)퍼널 목표 수치
| 단계 | 전환율 목표 |
|---|---|
| 공유율 | 30% |
| 가입 전환 | 20% |
| 몰연동 전환 | 60% |
| 결제 전환 | 50% |
이벤트 로깅
| 이벤트 | 파라미터 |
|---|---|
admin_viral_dashboard_viewed | admin_id, date_range |
admin_viral_filter_changed | admin_id, filter_type |
생성일: 2026-01-20