쿠폰 연동
소스라이브 쿠폰 기능을 자사몰의 쿠폰 시스템과 연동하는 가이드입니다. 어드민에서 쿠폰 클릭 이벤트 유형을 설정하면, 해당 유형이 소스라이브 플레이어 웹 SDK의 couponClick 이벤트 값(couponType)으로 전송됩니다.
▲ 플레이어의 쿠폰 탭 — 쿠폰 클릭 시 couponClick 이벤트가 전송됩니다
쿠폰 클릭 이벤트 유형
어드민 라이브 편성이나 라이브콘솔에서 쿠폰의 클릭 이벤트 유형을 설정합니다. 유형은 couponType 값으로 전달됩니다.
link
링크 이동
클릭 시 현재 창에서 지정된 URL로 이동
newWindow
새 창 열기
클릭 시 새 탭으로 지정된 URL을 오픈
download
쿠폰 코드 다운로드
쿠폰 코드로 자사몰 API 호출하여 발급
custom
사용자 정의
JSON metadata로 임의 값을 전달하여 처리
apiDownload
API 다운로드
어드민에 등록한 고객사 API를 플레이어가 직접 호출
📘 등록 여부
link·newWindow 쿠폰만 쓰면 couponClick을 등록하지 않는 것을 권장합니다. 웹 SDK가 linkUrl로 이동합니다. download·custom 쿠폰을 쓸 때 등록하세요. 등록하지 않으면 쿠폰 버튼을 눌러도 발급되지 않습니다.
이벤트 데이터
couponClick 처리 함수의 이벤트 값에 아래 필드가 전달됩니다. 앱스킴 필드는 브릿지 이벤트 레퍼런스에 있습니다.
| 필드 | 타입 | 설명 |
|---|---|---|
| couponType | String | null | 'link' | 'newWindow' | 'download' | 'custom' — 어드민에서 설정한 클릭 이벤트 유형. apiDownload 쿠폰은 이벤트가 전송되지 않습니다 |
| linkUrl | String | null | 링크 이동 URL. link / newWindow 유형에서 사용 |
| couponCode | String | null | 쿠폰 코드. download 유형에서 사용 |
| couponId | String | null | 등록된 쿠폰 ID |
| couponName | String | null | 등록된 쿠폰명 |
| metaData | String | null | 사용자 정의 데이터(JSON 문자열). custom 유형에서 사용 |
| broadcastId | String | 라이브 ID |
유형별 구현 예시
처리 함수를 아래처럼 등록한 뒤 couponType에 맞는 탭의 case를 넣으세요.
JavaScript — couponClick 등록
SauceLive.Player('on', 'couponClick', (e) => { switch (e.couponType) { // 아래 탭에서 쓰는 유형의 case를 넣는다 } })
⚠️ 등록하면 모든 유형을 자사몰 코드가 처리합니다.
link·newWindow 쿠폰도 함께 쓰면 그 탭의 case도 넣으세요.
현재 창에서 지정된 URL로 이동합니다.
linkUrl이 있을 때만 이동합니다.JavaScript
case 'link': if (e.linkUrl) location.href = e.linkUrl break
새 탭으로 지정된 URL을 엽니다. 라이브 시청을 끊지 않고 쿠폰 페이지를 확인할 때 적합합니다.
JavaScript
case 'newWindow': if (e.linkUrl) window.open(e.linkUrl, '_blank') break
쿠폰 코드(
couponCode)로 자사몰 API를 호출하여 쿠폰을 발급합니다. YOUR_COUPON_API를 실제 API URL로 교체하세요.JavaScript — 구조 참고용
case 'download': // YOUR_COUPON_API: 자사몰 쿠폰 발급 API URL fetch(`${YOUR_COUPON_API}/${e.couponCode}`) .then((res) => res.json()) .then((res) => { SauceLive.Player('showToast', res.success ? `${res.percent}% 쿠폰을 다운로드 받았습니다.` : '쿠폰이 모두 소진되었습니다.') }) .catch(() => SauceLive.Player('showToast', '쿠폰 다운로드 중 오류가 발생했습니다.')) break
어드민에서 JSON 형태로 저장한
metaData를 파싱하여 쿠폰 ID, 할인율 등 임의 데이터를 처리합니다.JavaScript — 구조 참고용
case 'custom': { // metaData 예: {"couponId":"1","title":"쿠폰1","discount":"10"} if (!e.metaData) break const { couponId, title, discount } = JSON.parse(e.metaData) fetch(`${YOUR_COUPON_API}/${couponId}`, { method: 'POST', body: JSON.stringify({ discount }) }) .then((res) => res.json()) .then((res) => { SauceLive.Player('showToast', res.success ? `${discount}% ${title} 쿠폰을 다운로드 받았습니다.` : '쿠폰이 모두 소진되었습니다.') }) .catch(() => SauceLive.Player('showToast', '오류가 발생했습니다.')) break }
API URL을 어드민에 등록하면 이벤트 등록 없이 플레이어가 API를 직접 호출합니다. 고객사 API가 아래 응답 규격을 지키면 플레이어가 결과를 표시합니다.
| HTTP 상태 | 상황 | 플레이어 표시 문구 |
|---|---|---|
| 200 OK | 정상 다운로드 | "쿠폰이 다운로드되었습니다." |
| 409 Conflict | 이미 다운로드한 쿠폰 | "이미 다운로드된 쿠폰입니다." |
| 410 Gone | 쿠폰 소진 | 문구 없이 쿠폰에 「마감」 표시 |
| 기타 | 오류 발생 | "쿠폰 다운로드에 실패했습니다." |
📌 API 다운로드 필수 파라미터: 플레이어는 API를 POST로 호출하며 JSON 본문에
couponCode와 accessToken(플레이어에 설정된 회원 토큰)을 넣습니다. API 서버에서 두 값을 검증하세요.
📘 앱 웹뷰에서 플레이어를 열 때는 앱 웹뷰 브릿지를 확인하세요.
Updated 4 days ago
Did this page help you?
