Story: 캠페인 행동 조언 (자동 광고)

메타

항목	값
Story ID	E-04-S-03
Epic	E-04 Phase 2 순이익 번역
상태	ready-for-dev
우선순위	P0
규모	L
담당 개발자	수민 (FE), 하록 (BE)

---

사용자 스토리

As a 자동 광고(AI스마트/매출최적화)를 사용하는 셀러,
I want 목표 ROAS를 얼마로 설정해야 하는지 알고 싶다,
So that 쿠팡 광고센터에서 바로 조정할 수 있다.

---

수락 기준 (Acceptance Criteria)

AC-01: 목표 ROAS 조정 조언 (방향성 제시)

항목	내용
Given	자동 광고이고 Margin Room 대비 광고비가 과할 때
When	캠페인 카드를 펼치면
Then	"목표 ROAS를 높여보세요" 방향성 조언이 표시된다
And	BEP ROAS와 현재 ROAS 비교 정보가 표시된다

⚠️ 데이터 제약: 목표 ROAS 현재값은 쿠팡 스크랩 데이터에 없어 구체적 값 제시 불가

AC-02: BEP ROAS 기반 판단

항목	내용
Given	목표 ROAS 변경 조언이 표시될 때
When	판단 근거를 보여줄 때
Then	BEP ROAS와 현재 ROAS를 비교해 보여준다

현재 ROAS: 280%
BEP ROAS: 367% (이 이상이면 순이익 발생)

💡 목표 ROAS를 높이면:
• 입찰가가 자동으로 낮아져요
• 노출은 줄 수 있지만, 효율이 올라가요

※ 목표 ROAS 현재값은 쿠팡 광고센터에서 확인하세요

AC-03: 쿠팡 광고센터 연결

항목	내용
Given	조언이 표시된 상태에서
When	"쿠팡 광고센터에서 목표 ROAS 조정하기" 버튼 클릭 시
Then	쿠팡 광고센터 캠페인 설정 페이지로 이동한다

AC-04: 자동 광고 타입 식별

항목	내용
Given	캠페인 데이터를 가져올 때
When	광고 타입이 AI스마트 또는 매출최적화일 때
Then	자동 광고로 분류하고 목표 ROAS 기반 조언 제공

---

데이터 제약사항 (2026-01-26)

⚠️ 쿠팡 광고 스크랩 데이터 한계로 인한 제약

데이터	상태	대안
목표 ROAS	❌ 없음	BEP ROAS 기반 방향성 제시
현재 입찰가	❌ 없음	CPC 기반 방향성 제시
예상 변화	❌ 계산 불가	제거 (목표 ROAS 현재값 모름)

핵심 원칙:

• 구체적 값("목표 ROAS 400%로") 대신 방향성("목표 ROAS를 높여보세요") 제시
• 쿠팡 광고센터 링크로 유도하여 셀러가 직접 확인/조정

---

태스크 분해

Task 1: BE - 자동 광고 조언 로직 AC-01, AC-02, AC-04

• [ ] 1.1: 자동/수동 광고 타입 식별 로직
• [ ] 1.2: Margin Room 대비 광고비 과다 판정
• [ ] 1.3: BEP ROAS 계산
  • BEP ROAS = 100 / marginRate × 100 × 1.1 (VAT 포함)
• [ ] 1.4: 조언 케이스 판정 (P-1a ~ P-7c)
  • 손해: ROAS < BEP → 효율 개선 필요
  • 본전: 0 ≤ 순이익 < 30원 → Margin Room 비교
  • 건강: 순이익 ≥ 30원 → 마진별 확장 가능성

Task 2: FE - 조언 UI AC-01, AC-02, AC-03

• [ ] 2.1: 자동 광고 조언 카드 컴포넌트
• [ ] 2.2: 목표 ROAS 비교 UI (현재 → 권장)
• [ ] 2.3: 예상 변화 표시 (+X원)
• [ ] 2.4: 쿠팡 광고센터 링크 버튼
• [ ] 2.5: GA4 이벤트 (click_action_advice)

---

계산 로직 상세

[BEP ROAS 계산]
BEP ROAS = 100 / marginRate × 100 × 1.1 (VAT 포함)

예) 마진율 30% → BEP ROAS = 100 / 30 × 100 × 1.1 = 367%
→ ROAS가 367% 이상이면 순이익 발생

[허용 CPC 계산]
허용 CPC = (평균 주문금액 × CVR) / BEP ROAS × (1 - Margin Room%)

예) 평균 주문금액 30,000원, CVR 3%, BEP ROAS 367%, MarginRoom 70%
→ 허용 CPC = (30,000 × 0.03) / 3.67 × 0.3 = 73원

[조언 판정 플로우]
100원당 순이익 기준:
├─ < 0 (손해) → 🔴 효율 개선 필요
│   └─ "쿠팡 광고센터에서 목표 ROAS를 높여보세요"
├─ 0 ~ 30 (본전) → 🟡 Margin Room 비교
│   └─ 광고비 > MarginRoom → "효율 개선 검토"
└─ ≥ 30 (건강) → 🟢 마진별 확장 가능성
    ├─ 마진 ≥ 30% → "확장 여지 충분"
    ├─ 마진 20-30% → "소폭 확장 가능, 주의"
    └─ 마진 < 20% → "현 수준 유지 권장"

※ 목표 ROAS 구체적 권장값은 쿠팡 데이터 제약으로 제시 불가

---

이벤트 로깅

이벤트명	트리거	파라미터
view_auto_ad_advice	자동 광고 조언 노출	{campaign_id, current_roas, recommended_roas}
click_action_advice	조언 클릭	{advice_type: 'target_roas', campaign_id}

---

Dev Notes

자동 광고 타입

DB 값	표시	분류
AI_SMART	AI스마트	자동
SALES_OPTIMIZE	매출최적화	자동

API 응답 예시

{
  "campaignId": "123",
  "adType": "auto",
  "profitPer100": 5,
  "profitStatus": "breakeven",
  "bepRoas": 367,
  "currentRoas": 280,
  "marginRate": 30,
  "advice": {
    "caseCode": "P-5",
    "type": "efficiency_improve",
    "direction": "up",
    "title": "Margin Room 기준 광고비가 초과예요",
    "message": "균형형 기준으로 광고비가 과해요. 쿠팡 광고센터에서 목표 ROAS를 높여보세요.",
    "action": "효율 개선 (쿠팡에서)",
    "actionUrl": "https://ads.coupang.com/campaign/123/settings"
  }
}

※ currentTargetRoas, recommendedTargetRoas, expectedChange 제거됨 (쿠팡 데이터 없음)

### 의존성

- E-04-S-01: 순이익 번역 (profitPer100)
- E-04-S-02: Margin Room 설정

---

*생성일: 2026-01-20*<br>