쿠팡 파트너스 연동
무료박스 2회차 오픈

1. 목적 및 대안 비교왜 광고가 아니라 쿠팡인가

1.1 문제

• 무료박스는 1일 1회가 상한이다. 하루 안에 유저가 앱에서 할 수 있는 무료 행동이 한 번뿐이라 세션이 30초 만에 끝난다.
• "한 번 더 열고 싶다"는 순간이 매일 발생하는데, 현재는 "이미 오픈하셨습니다 + [확인]"으로 대화가 끝난다. 이 모달이 앱에서 가장 아까운 지면이다.
• 2회차를 무상으로 주면 비용만 2배가 된다. 수익이 붙은 행동과 교환해야 한다.

1.2 대안 비교

1.3 성공 지표

2. 핵심 규칙확정 정책

2.1 지급 조건

2.2 15초 체류 조건

• 클릭 즉시 지급하면 유저는 버튼 → 즉시 뒤로가기를 학습한다. 쿠팡 페이지가 렌더링조차 안 되고 전환율이 0에 수렴한다.
• 15초는 상품 페이지가 로드되고 첫 스크롤이 일어나는 최소 시간이다. 그 이상(30초·60초)은 이탈만 늘린다.
• 판정은 전적으로 서버 시각 기준이다. 클라이언트가 보낸 체류시간은 신뢰하지 않는다.
  claim 요청 시각 − click 기록 시각 ≥ 15초

2.3 클릭 유효기간

• 클릭 기록은 당일 KST 자정까지 유효. 자정을 넘기면 claim 불가(다음 날 새 클릭 필요).
• 쿠팡 파트너스 쿠키는 24시간이라 수익 인정 기간이 우리 유효기간보다 길다. 유저에게 유리한 방향의 불일치이므로 문제되지 않는다.

3. 단위경제DAU 1만 · 참여율 40% = 4,000클릭/일 기준

3.1 비용 (클릭 1회당)

3.2 수익 (클릭 1회당 = EPC)

EPC = 객단가 × 전환율 × 수수료율 ÷ 1.1(VAT)

• 수수료율: 뷰티·패션·스포츠·출산육아 3% / 생활·식품·건강 2% / 가전·디지털 1% — 실효 약 2%
• 쿠키 유효기간 24시간, 정산 익월~익익월 15일, 최소 지급 월 2만원
• 업계 실측 EPC: 10~15원 (매체사별 편차 큼) — 역산 시 전환율 약 2%. 쿠팡 헤비유저는 24시간 내 자연 구매 빈도가 높아 last-click이 잡히는 구조로 설명된다

3.3 손익

3.4 민감도 — redemption rate

redemption 50%는 실측이 아니라 가정이다. 그리고 출석 보너스·2회차 도입으로 팡 적립 속도가 빨라지면 이 값은 올라간다. 이 기능이 스스로 전제를 무너뜨리는 방향으로 작동하므로 반드시 감시해야 한다.

3.5 파생 효과 (수익에 미포함)

• 2회차 오픈으로 경험치 10 추가 → 레벨업 가속 → 무료박스 팡 계수 상승 (비용 증가 요인, 장기 반영 필요)
• 세션 시간 증가 → 유료박스 노출 증가 → 유료 전환 lift (측정 필요)
• 쿠팡 클릭 자체가 매체사 정산 대상이 아니다 — 수익 분배(75:25) 무관, 전액 브라보식스 귀속 확정 필요

4. 매체사별 수익성 관리이 기능의 생사를 가르는 부분

EPC 10~15원은 평균이다. 매체사 유저 품질에 따라 3원도 15원도 나온다. 저품질 매체사가 섞이면 그 매체사에서만 조용히 적자가 나고, 전체 평균에 묻혀 몇 달 동안 발견되지 않는다.

4.1 서브ID 매핑 BE

• 쿠팡 파트너스 딥링크의 subId 파라미터에 매체사 코드를 삽입한다.
  subId = "{partner_code}_{yyyymm}" — 예: abc_202608
• 쿠팡 파트너스 리포트에서 subId별 수익이 분리 집계 → 매체사별 EPC 산출 가능
• 수익 데이터는 파트너스 리포트 수동 다운로드 또는 API로 월 1회 이상 취합해 coupang_revenue_daily에 적재

4.2 자동 차단 임계치

경고선 9원은 BEP 6.5원에 안전계수 1.4를 적용한 값이다. redemption이 가정보다 높게 나올 여지를 흡수한다.

4.3 관리자 대시보드 추가 지표

• 매체사별 · 일별: 노출 / 클릭 / 클릭률 / claim 성공률 / 지급 팡 / EPC / 순익
• 전체: 2회차 참여율(1회차 오픈자 대비), 15초 미달 이탈률
• 보너스 팡 소진율 — redemption 실측치. 3.4 민감도표 갱신용 최우선
• 매체사별 기능 ON/OFF 토글 + 프리셋 선택(기본 / 전용 저가)

5. 지면 전략 — 몰파이와의 정리같은 자리를 두고 경쟁한다

5.1 정리안

원칙: 한 지면에 제휴 CTA는 하나만. 유저가 "무엇을 눌러야 하는가"를 0.5초 안에 판단할 수 없으면 그 지면은 죽는다.

6. UI 설계디자인팀 전달용

6.1 배치 맵

6.2 화면 흐름

6.3 화면 시안

6.4 대가성 문구 디자인 법적 필수

7. 데이터 모델 DB

7.1 coupang_click_logs — 클릭 원장

7.2 coupang_revenue_daily — 수익 적재 (수동/API 취합)

7.3 정책값 — reward_policies

key   : "coupang_freebox"
value : {
  "enabled": true,
  "dwellSeconds": 15,
  "dailyLimit": 1,
  "requireFirstBoxOpened": true,
  "presetMode": "DEFAULT",      // DEFAULT | LOW_COST
  "applyAttendanceBonus": true,
  "epcWarnKrw": 9.0,
  "epcBlockKrw": 6.5,
  "partnerOverrides": {          // 매체사별 개별 설정
    "abc": { "enabled": false },
    "xyz": { "presetMode": "LOW_COST" }
  }
}

8. API 명세 BE

8.1 GET /api/coupang/status

{
  "available": true,        // 오늘 2회차 참여 가능 여부
  "reason": null,           // FIRST_BOX_NOT_OPENED | ALREADY_CLAIMED | DISABLED | GUEST
  "clicked": true,
  "claimable": false,
  "remainSec": 12,          // 서버 계산. 0이면 즉시 수령 가능
  "claimed": false
}

8.2 POST /api/coupang/click

클릭 기록 + 딥링크 반환. 딥링크는 서버가 생성한다 (subId 위조 방지).

// Response
{
  "redirectUrl": "https://link.coupang.com/a/XXXXX?subId=abc_202608",
  "dwellSeconds": 15,
  "clickedAt": "2026-08-07T05:12:33Z"
}

이미 오늘 클릭한 경우 동일 클릭 레코드의 redirectUrl을 재반환(신규 생성 안 함). clicked_at은 갱신하지 않는다 — 갱신하면 15초 카운트가 리셋되어 유저가 영원히 못 받는다.

8.3 POST /api/coupang/claim

요청 바디 없음. 서버가 전부 판정한다.

{ "pang": { "base": 20, "bonus": 2, "total": 22, "bonusRate": 0.10, "streakDay": 3 },
  "product": { ... },
  "exp": 10 }

9. 서버 로직 BE

click(userId):
  p = policy("coupang_freebox", partnerOf(userId))
  if !p.enabled: throw DISABLED
  if p.requireFirstBoxOpened and !freeBoxOpenedToday(userId): throw FIRST_BOX_NOT_OPENED

  lock("coupang:" + userId)
  today = kstToday()
  log   = clickRepo.find(userId, today)

  if log == null:
     subId = partnerCode + "_" + yyyymm()
     log   = clickRepo.insert(userId, today, subId, deeplink(subId), now())
  // 이미 있으면 그대로 재사용 — clicked_at 절대 갱신 금지

  return { redirectUrl: log.landing_url, dwellSeconds: p.dwellSeconds }


claim(userId):
  p   = policy("coupang_freebox", partnerOf(userId))
  lock("coupang:" + userId)
  log = clickRepo.find(userId, kstToday())

  if log == null:            throw NO_CLICK
  if log.claimed_at != null: throw ALREADY_CLAIMED

  elapsed = now() - log.clicked_at                  // 전적으로 서버 시각
  if elapsed < p.dwellSeconds:
     throw DWELL_NOT_MET(remainSec = p.dwellSeconds - elapsed)

  preset = (p.presetMode == "LOW_COST") ? LOW_COST_PRESET : DEFAULT_PRESET

  tx:
     box = freeBoxService.open(userId, preset,
                               applyBonus = p.applyAttendanceBonus,
                               source     = "COUPANG_2ND")
     log.claimed_at  = now()
     log.free_box_id = box.id
     clickRepo.save(log)

  return box

10. 쿠팡 파트너스 정책 준수이 기능이 죽는다면 여기서 죽는다

10.1 공식 계정 정지 사유 대응

10.2 진짜 리스크는 약관이 아니라 트래픽 품질

10.3 단계적 오픈 운영

1. 1단계 — 테스트 앱 단독(DAU ~200)으로 2주. EPC 실측 + 정지 리스크 관측
2. 2단계 — EPC 9원 이상 확인 시 매체사 1곳 추가, 2주
3. 3단계 — 전 매체사 확대. 이후 자동 차단 임계치로 상시 관리

계정이 정지되면 쿠팡 파트너스 수익 전체가 멈춘다. 한 번에 전 매체사를 열지 않는다.

10.4 자사 약관·방침

• 약관 v1.1에 제휴 쇼핑 조항이 없다 → 몰파이와 동일하게 최초 진입 시 별도 동의 수령 권장
• 개인정보처리방침 — 쿠팡으로 개인정보를 전송하지 않는다(subId는 매체사 코드). 제3자 제공 조항 추가 불필요
  단, "외부 사이트로 이동 시 해당 사이트의 정책이 적용됨"을 안내 문구로 명시
• 수수료 수익의 세무 처리 — 파트너스 수익은 법인 기타수익으로 계상, 정산 60일 갭 고려 재무 확인

11. 어뷰징 · 엣지케이스

11.1 어뷰징

11.2 엣지케이스

12. QA 테스트 케이스

13. 개발 범위 · 일정

14. 확정 필요 사항

범위 밖 (2차)

• 쿠팡 상품 큐레이션 (수수료 3% 카테고리 우선 노출로 EPC 상승) — 효과 가장 큼, 2차 최우선
• 클릭 → 실제 구매 확인 시 추가 보상 (CPS 하이브리드)
• 다른 제휴사 병행 (11번가·G마켓 등) 및 EPC 기반 자동 라우팅
• 2회차를 넘어선 3·4회차 확장