Story: 검색/비검색 진단 메시지

메타

항목	값
Story ID	E-03-S-03
Epic	E-03 Surface Layer
상태	ready-for-dev
우선순위	P0
규모	S
담당 개발자	수민 (FE), 하록 (BE)

---

사용자 스토리

As a 초보 셀러,
I want 왜 이 상태인지, 뭘 해야 하는지 쉬운 말로 알고 싶다,
So that 쿠팡 광고센터에서 바로 조정할 수 있다.

---

수락 기준 (Acceptance Criteria)

AC-01: 검색 광고 진단 메시지

항목	내용
Given	검색 광고가 🔴 또는 🟡일 때
When	카드가 펼쳐지면
Then	상황별 진단 메시지가 표시된다

S1. CTR 부족: "검색에서 노출은 되는데 클릭이 적어요"
S2-a. CVR < 1%: "🔴 전환이 거의 없어요 (CVR {X}%)"
S2-b. CVR 1-3%: "🟡 전환이 낮아요 (CVR {X}%)"
S2-c. CVR 3-5%: "💡 전환 개선 여지 있어요 (CVR {X}%)"
S3. 광고비 과다(자동): "검색 광고비가 높아요. 목표 ROAS를 높여보세요"
S4. 광고비 과다(수동): "검색 키워드 입찰가가 높아요. 입찰가를 낮춰보세요"
S5. 데이터 수집 중: "🟡 데이터 쌓이는 중이에요" (2026-01-28 변경)

⚠️ 데이터 제약: 목표 ROAS/입찰가 구체적 값은 쿠팡 스크랩 데이터에 없음 → 방향성만 제시

AC-02: 비검색 광고 진단 메시지

항목	내용
Given	비검색 광고가 🔴 또는 🟡일 때
When	카드가 펼쳐지면
Then	상황별 진단 메시지가 표시된다

N1. 노출 부족: "비검색 노출이 적어요. 입찰가를 올려보세요"
N2. CTR 부족: "비검색에서 노출은 많은데 클릭이 적어요"
N3-a. CVR < 1%: "🔴 비검색 전환이 거의 없어요 (CVR {X}%)"
N3-b. CVR 1-3%: "🟡 비검색 전환이 낮아요 (CVR {X}%)"
N4. 광고비 과다: "비검색 광고비가 높아요. 입찰가를 낮춰보세요"
N5. 데이터 수집 중: "🟡 데이터 쌓이는 중이에요" (2026-01-28 변경)
~~N6. OFF 권고~~ (삭제됨 - 1일치 데이터 기준 "7일 지속" 조건 판단 불가)

⚠️ 데이터 제약: 비검색 입찰가 구체적 값은 쿠팡 스크랩 데이터에 없음 → 방향성만 제시

AC-02-1: 리타게팅 광고 진단 메시지 ⭐ 신규 (2026-01-27)

항목	내용
Given	리타게팅 광고가 🔴 또는 🟡일 때
When	카드가 펼쳐지면
Then	상황별 진단 메시지가 "참고" 수준으로 표시된다

R1. 노출 부족: "리타게팅 노출이 적어요 → 쿠팡 자동 운영 영역 (참고)"
R2. CVR 부족: "리타게팅 전환이 낮아요 → 상품 페이지 점검 권장"
R3. 광고비 비중 높음: "리타게팅 비중이 높아요 (X%) → 검색/비검색 먼저 점검"
R4. 데이터 수집 중: "🟡 데이터 쌓이는 중이에요" (2026-01-28 추가)

※ 리타게팅 특성:
• CPC가 낮아서 (39원) 상대적으로 효율적인 편
• 셀러 직접 컨트롤 불가 (쿠팡 자동 운영)
• 상품 페이지 전환율 개선으로 간접 효율 향상 가능

AC-03: 조합 진단 메시지 (C-01 ~ C-06, R-1 ~ R-3)

항목	내용
Given	검색/비검색/리타게팅 상태 조합에 따라
When	캠페인 카드가 펼쳐지면
Then	조합 케이스별 메시지가 우선 표시된다

[기존 검색/비검색 조합]
C-01. 검색 🔴 + 비검색 🟢: "검색 광고가 발목을 잡고 있어요" → 검색 먼저
C-02. 검색 🟢 + 비검색 🔴: "비검색 광고가 발목을 잡고 있어요" → 비검색 먼저
C-03. 검색 🔴 + 비검색 🔴: "검색과 비검색 모두 점검이 필요해요" → 광고비 비중 높은 쪽 먼저
C-04. 검색 🟡 + 비검색 🟡: "전체적으로 본전이에요" → 마진 구조 확인
C-05. 검색 🟢 + 비검색 🟢: "캠페인이 건강해요! ✨" → 현 세팅 유지
~~C-06. 검색 ⚪ + 비검색 ⚪~~ (삭제됨 - 🟡 데이터 수집 중으로 대체)

[리타게팅 조합 - 신규]
R-1. 검색/비검색 🟢 + 리타게팅 🔴: "검색/비검색은 괜찮은데 리타게팅이 손해예요 (참고)"
R-2. 검색/비검색 🔴 + 리타게팅 🟢: "리타게팅은 괜찮아요. 검색/비검색 먼저 점검하세요"
R-3. 전체 🔴 + 리타게팅만 건강: "리타게팅은 잘 되고 있어요. 검색/비검색 집중!"

※ 리타게팅은 항상 검색/비검색 이후에 참고 수준으로 표시

---

태스크 분해

Task 1: BE - 진단 조건 판별 AC-01, AC-02, AC-02-1

• [ ] 1.1: 검색 진단 조건 구현 (S1, S2-a/b/c, S3~S5)
• [ ] 1.2: 비검색 진단 조건 구현 (N1~N2, N3-a/b, N4~N6)
• [ ] 1.3: 리타게팅 진단 조건 구현 (R1~R3) ⭐ 신규
• [ ] 1.4: 진단 코드 + 메시지 템플릿 반환
• [ ] 1.5: 방향성 메시지 반환 (목표 ROAS/입찰가 구체값 없음)
• [ ] 1.6: 리타게팅 "참고" 플래그 처리

Task 2: BE - 조합 진단 로직 AC-03

• [ ] 2.1: 검색/비검색 상태 조합 판정 (C-01~C-06)
• [ ] 2.2: 리타게팅 조합 판정 (R-1~R-3) ⭐ 신규
• [ ] 2.3: 광고비 비중 계산 (C-03용 우선순위 결정)
• [ ] 2.4: 조합 케이스 코드 + 메시지 반환

Task 3: FE - 메시지 표시 AC-01, AC-02, AC-03

• [ ] 3.1: 진단 메시지 컴포넌트
• [ ] 3.2: 조합 메시지 우선 표시 로직
• [ ] 3.3: 메시지 스타일 (💡🔴🟡 아이콘 분기)
• [ ] 3.4: 조합 케이스별 우선 액션 하이라이트

---

변경 이력

날짜	변경 내용
2026-01-20	스토리 생성
2026-01-26	데이터 제약사항 반영: CVR 케이스 세분화 (S2→S2-a/b/c, N3→N3-a/b), 목표 ROAS/입찰가 구체값 제시 불가 → 방향성 제시로 변경
2026-01-26	조합 진단 AC 확장: AC-03에 C-01~C-06 케이스 명시, Task 2 조합 진단 BE 로직 추가
2026-01-28	데이터 수집 중 케이스 변경: S5, N5, R4 → "🟡 데이터 쌓이는 중이에요"로 변경, N6/C-06 삭제 반영

---

생성일: 2026-01-20
최종 수정: 2026-01-28