테마
Story: 액션 가이드 연결
메타
| 항목 | 값 |
|---|---|
| Story ID | E-03-S-04 |
| Epic | E-03 Surface Layer |
| 상태 | ready-for-dev |
| 우선순위 | P1 |
| 규모 | S |
| 담당 개발자 | 수민 (FE) |
사용자 스토리
As a 초보 셀러,
I want 진단 결과에 맞는 액션 버튼을 누르면 쿠팡 광고센터로 바로 가고 싶다,
So that 뭘 해야 할지 알고 바로 실행할 수 있다.
수락 기준 (Acceptance Criteria)
AC-01: 검색 광고 액션 버튼
| 항목 | 내용 |
|---|---|
| Given | 검색 광고 진단 메시지가 표시된 상태에서 |
| When | 액션 버튼을 클릭하면 |
| Then | 쿠팡 광고센터의 해당 설정 페이지로 이동한다 |
S1. CTR 부족 → "쿠팡 광고센터에서 키워드 확인하기"
S2-a/b/c. CVR 부족 → "쿠팡에서 상품 페이지 확인하기"
S3. 광고비 과다(자동) → "쿠팡 광고센터에서 목표 ROAS 높이기"
S4. 광고비 과다(수동) → "쿠팡 광고센터에서 키워드 입찰가 낮추기"
S5. 데이터 부족 → 버튼 없음 (대기 안내)⚠️ 데이터 제약: 목표 ROAS/입찰가 권장값 제시 불가 → 방향성만 제시 ("높이기", "낮추기")
AC-02: 비검색 광고 액션 버튼
| 항목 | 내용 |
|---|---|
| Given | 비검색 광고 진단 메시지가 표시된 상태에서 |
| When | 액션 버튼을 클릭하면 |
| Then | 쿠팡 광고센터의 해당 설정 페이지로 이동한다 |
N1. 노출 부족 → "쿠팡 광고센터에서 비검색 입찰가 올리기"
N2. CTR 부족 → "쿠팡에서 상품 이미지 확인하기"
N3-a/b. CVR 부족 → "쿠팡에서 상품 페이지 확인하기"
N4. 광고비 과다 → "쿠팡 광고센터에서 비검색 입찰가 낮추기"
N5. 데이터 부족 → 버튼 없음 (대기 안내)
N6. OFF 권고 → "쿠팡 광고센터에서 비검색 입찰가 최소화"⚠️ 데이터 제약: 비검색 입찰가 권장값 제시 불가 → 방향성만 제시
AC-02-1: 리타게팅 광고 액션 버튼 ⭐ 신규 (2026-01-27)
| 항목 | 내용 |
|---|---|
| Given | 리타게팅 광고 진단 메시지가 표시된 상태에서 |
| When | 액션 버튼을 클릭하면 |
| Then | 참고 수준 액션으로 안내한다 (셀러 직접 컨트롤 불가) |
R1. 노출 부족 → "쿠팡 자동 운영 영역입니다 (참고)" (버튼 없음)
R2. CVR 부족 → "쿠팡에서 상품 페이지 확인하기" (간접 개선)
R3. 광고비 비중 높음 → "검색/비검색 먼저 점검하세요" (버튼 없음)⚠️ 리타게팅 특성: 셀러 직접 컨트롤 불가 → 상품 페이지 전환율 개선으로 간접 효율 향상
AC-03: 외부 링크 처리
| 항목 | 내용 |
|---|---|
| Given | 액션 버튼을 클릭할 때 |
| When | 쿠팡 광고센터로 이동하면 |
| Then | 새 탭으로 열린다 (target="_blank") |
| And | rel="noopener noreferrer" 적용 |
AC-04: GA4 이벤트 로깅
| 항목 | 내용 |
|---|---|
| Given | 액션 버튼을 클릭할 때 |
| When | 검색 액션 클릭 시 |
| Then | click_search_action 이벤트 발생 |
| When | 비검색 액션 클릭 시 |
| Then | click_nonsearch_action 이벤트 발생 |
태스크 분해
Task 1: 액션 버튼 컴포넌트 AC-01, AC-02, AC-03
- [ ] 1.1: 액션 버튼 컴포넌트 구현 (외부 링크 처리)
- [ ] 1.2: 진단 코드별 버튼 텍스트/URL 매핑
- [ ] 1.3: 데이터 부족 시 버튼 숨김 처리
Task 2: 쿠팡 광고센터 URL 매핑
- [ ] 2.1: 광고센터 URL 구조 확인 및 상수화
- [ ] 2.2: 캠페인 ID 기반 딥링크 구성
Task 3: GA4 이벤트 AC-04
- [ ] 3.1: click_search_action 이벤트 구현
- [ ] 3.2: click_nonsearch_action 이벤트 구현
- [ ] 3.3: action_type 파라미터 정의 (ctr_fix, cvr_fix, roas_adjust, bid_adjust 등)
이벤트 로깅
| 이벤트명 | 트리거 | 파라미터 |
|---|---|---|
click_search_action | 검색 액션 버튼 클릭 | {campaign_id, action_type} |
click_nonsearch_action | 비검색 액션 버튼 클릭 | {campaign_id, action_type} |
click_retargeting_action | 리타게팅 액션 버튼 클릭 ⭐ | {campaign_id, action_type} |
action_type 값
| 값 | 의미 | 비고 |
|---|---|---|
keyword_check | 키워드 확인 | S1 |
product_page | 상품 페이지 확인 | S2, N3 |
target_roas_up | 목표 ROAS 높이기 | S3 (자동광고) |
keyword_bid_down | 키워드 입찰가 낮추기 | S4 (수동광고) |
image_check | 상품 이미지 확인 | N2 |
nonsearch_bid_up | 비검색 입찰가 올리기 | N1 |
nonsearch_bid_down | 비검색 입찰가 낮추기 | N4 |
nonsearch_minimize | 비검색 최소화 | N6 |
retarget_page_check | 상품 페이지 확인 (리타게팅) ⭐ | R2 |
retarget_info_only | 정보만 제공 (참고) ⭐ | R1, R3 |
⚠️ 방향성 일관성: 구체적 값 대신 방향성 액션으로 통일 (up/down) ⚠️ 리타게팅 특성: 셀러 직접 컨트롤 불가 → 참고 수준 액션만 제공
Dev Notes
쿠팡 광고센터 URL 구조
기본: https://ads.coupang.com/
캠페인 관리: /campaign/list
키워드 관리: /keyword/list?campaignId={id}
입찰가 조정: /bid/manage?campaignId={id}의존성
- E-03-S-03 진단 메시지 스토리와 함께 동작
변경 이력
| 날짜 | 변경 내용 |
|---|---|
| 2026-01-20 | 스토리 생성 |
| 2026-01-26 | 데이터 제약사항 반영: CVR 케이스 세분화 (S2→S2-a/b/c, N3→N3-a/b), 액션 버튼 텍스트 방향성 제시로 변경 ("조정하기"→"높이기/낮추기"), action_type 값 방향성 일관성 적용 |
생성일: 2026-01-20
최종 수정: 2026-01-26