리워드 연동
시청자가 리워드 조건을 달성하고 버튼을 클릭하면 소스라이브 플레이어 웹 SDK가 rewardClick 이벤트를 전송합니다. 등록하지 않으면 웹 SDK가 리워드 연결 URL로 이동하고, 이벤트를 등록하면 자사몰의 리워드 API 호출, 포인트 지급 등 원하는 처리를 구현할 수 있습니다.
리워드 동작 흐름
시청자가 리워드에 참가하고 조건 시간을 채우면 CLICK 버튼이 노출되며, 이를 클릭할 때 이벤트가 전송됩니다.
1
라이브콘솔에서 리워드 등록
리워드 이름, 조건, 연결 URL을 설정합니다. 연결 URL은
linkUrl로 전달됩니다.2
시청자가 리워드 참가
라이브 중 시청자가 리워드 참가 버튼을 클릭합니다.
3
조건 시간 시청 · CLICK 버튼 노출
참가 클릭 이후 리워드 조건으로 정한 시간(분)만큼 시청하면 플레이어에 CLICK 버튼이 표시됩니다. 영상이 멈춘 동안은 시간을 세지 않습니다.
⏱ 조건 시간 시청 필요
4
CLICK 버튼 클릭 → 이벤트 전송
시청자가 버튼을 클릭하면 웹 SDK가
rewardClick 이벤트를 자사몰로 전송합니다.🎯 브릿지 이벤트 발생
5
자사몰에서 처리
리워드 API 호출, 포인트 지급, 링크 이동 등 자사몰의 비즈니스 로직을 수행합니다.
→
조건 시간 뒤
📌 연결 URL 필수: 리워드 등록 시 연결 URL이 비어 있으면 CLICK 버튼이 노출되지 않습니다. 라이브콘솔에서 반드시 설정하세요.
이벤트 데이터
rewardClick 처리 함수의 이벤트 값에 아래 필드가 전달됩니다.
| 필드 | 타입 | 필수 | 설명 |
|---|---|---|---|
| linkUrl | String | null | 필수 | 라이브콘솔에서 설정한 리워드 연결 URL |
| broadcastId | String | 필수 | 라이브 ID |
처리 시나리오
로그인 상태에 따라 처리가 달라집니다. rewardClick을 등록하면 두 경우를 모두 처리해야 합니다.
📘 등록 여부
연결 URL로 이동만 하면
연결 URL로 이동만 하면
rewardClick을 등록하지 않아도 웹 SDK가 linkUrl로 이동합니다. 로그인한 시청자에게 자사몰이 포인트·쿠폰을 바로 지급할 때 등록하세요.
✅ 로그인 상태
자사몰 리워드 API를 호출하여 포인트·쿠폰 등을 즉시 지급합니다. 회원 식별값을 API에 함께 전달하세요.
로그인하지 않은 상태
linkUrl로 이동시킵니다. 로그인 후 리워드를 수령하도록 안내하는 페이지로 연결하는 것을 권장합니다.
구현 예시
로그인 여부를 확인하여 분기 처리하는 패턴입니다. YOUR_REWARD_API·isLogin·memberData는 자사몰 환경에 맞게 교체하세요.
JavaScript — 기본 패턴
SauceLive.Player('on', 'rewardClick', (e) => { // 로그인 상태이면 자사몰 리워드 API 호출 if (isLogin && memberData) { fetch(`${YOUR_REWARD_API}/${memberData}`, { method: 'POST', headers: { 'Content-Type': 'application/json' }, body: JSON.stringify({ broadcastId: e.broadcastId }) }) .then((res) => res.json()) .then((res) => { SauceLive.Player('showToast', res.success ? '리워드 포인트가 지급되었습니다.' : '리워드 포인트가 모두 소진되었습니다.') }) .catch(() => SauceLive.Player('showToast', '리워드 지급 중 오류가 발생했습니다.')) } else { // 게스트이면 연결 URL(로그인 안내 페이지 등)로 이동 if (e.linkUrl) location.href = e.linkUrl } })
📘 개발 단계에서는 이벤트 값을 로그로 먼저 확인한 뒤 API 연동을 붙이세요.
브릿지 이벤트 통합 등록 예시
여러 이벤트를 등록할 때는 설치 코드 뒤 한곳에 모아 두세요. 상품 클릭은 기본 동작을 쓰므로 등록하지 않았습니다.
JavaScript — 통합 등록
// 로그인 연동 SauceLive.Player('on', 'loginClick', () => { location.href = `/signin?returnUrl=${encodeURIComponent(location.pathname + location.search)}` }) // 상품 클릭: 현재 창 이동이면 등록하지 않는다 // 웹 SDK가 linkUrl로 이동한다. 등록하면 플로팅 이어 보기가 동작하지 않는다 // 쿠폰: 등록하면 link · newWindow 이동도 자사몰 코드가 처리한다(쿠폰 연동) SauceLive.Player('on', 'couponClick', (e) => { switch (e.couponType) { case 'link': if (e.linkUrl) location.href = e.linkUrl break case 'newWindow': if (e.linkUrl) window.open(e.linkUrl, '_blank') break case 'download': // e.couponCode로 자사몰 쿠폰 발급 API 호출 break case 'custom': // e.metaData(JSON 문자열)로 자사몰 쿠폰 처리 break } }) // 리워드 SauceLive.Player('on', 'rewardClick', (e) => { if (isLogin && memberData) { // 리워드 API 호출 } else if (e.linkUrl) { location.href = e.linkUrl } })
📘 라이브 시작 알림은 라이브 알림 버튼 연동에서 다룹니다. 각 이벤트의 상세 데이터는 브릿지 이벤트 레퍼런스에 있습니다.
📘 앱 웹뷰에서 플레이어를 열 때는 앱 웹뷰 브릿지를 확인하세요.
Updated 4 days ago
Did this page help you?
