GuidesAPI GuideChangelog
Log In
Guides

리워드 연동

시청자가 리워드 조건을 달성하고 버튼을 클릭하면 소스라이브 플레이어 웹 SDK가 rewardClick 이벤트를 전송합니다. 등록하지 않으면 웹 SDK가 리워드 연결 URL로 이동하고, 이벤트를 등록하면 자사몰의 리워드 API 호출, 포인트 지급 등 원하는 처리를 구현할 수 있습니다.

리워드 연동 — 소스라이브 플레이어
⏱ 예상 소요 시간: 20분
📋 사전 조건: 브릿지 이벤트 연동 완료
⚙️ 라이브콘솔에서 리워드 등록 필요
리워드 동작 흐름

시청자가 리워드에 참가하고 조건 시간을 채우면 CLICK 버튼이 노출되며, 이를 클릭할 때 이벤트가 전송됩니다.

1
라이브콘솔에서 리워드 등록
리워드 이름, 조건, 연결 URL을 설정합니다. 연결 URL은 linkUrl로 전달됩니다.
2
시청자가 리워드 참가
라이브 중 시청자가 리워드 참가 버튼을 클릭합니다.
3
조건 시간 시청 · CLICK 버튼 노출
참가 클릭 이후 리워드 조건으로 정한 시간(분)만큼 시청하면 플레이어에 CLICK 버튼이 표시됩니다. 영상이 멈춘 동안은 시간을 세지 않습니다.
⏱ 조건 시간 시청 필요
4
CLICK 버튼 클릭 → 이벤트 전송
시청자가 버튼을 클릭하면 웹 SDK가 rewardClick 이벤트를 자사몰로 전송합니다.
🎯 브릿지 이벤트 발생
5
자사몰에서 처리
리워드 API 호출, 포인트 지급, 링크 이동 등 자사몰의 비즈니스 로직을 수행합니다.
리워드 참가 버튼
① 참가 버튼
→
조건 시간 뒤
리워드 CLICK 버튼
② CLICK 버튼
📌 연결 URL 필수: 리워드 등록 시 연결 URL이 비어 있으면 CLICK 버튼이 노출되지 않습니다. 라이브콘솔에서 반드시 설정하세요.
이벤트 데이터

rewardClick 처리 함수의 이벤트 값에 아래 필드가 전달됩니다.

필드타입필수설명
linkUrl String | null 필수 라이브콘솔에서 설정한 리워드 연결 URL
broadcastId String 필수 라이브 ID
처리 시나리오

로그인 상태에 따라 처리가 달라집니다. rewardClick을 등록하면 두 경우를 모두 처리해야 합니다.

📘 등록 여부
연결 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
  }
})
📘 라이브 시작 알림은 라이브 알림 버튼 연동에서 다룹니다. 각 이벤트의 상세 데이터는 브릿지 이벤트 레퍼런스에 있습니다.
📘 앱 웹뷰에서 플레이어를 열 때는 앱 웹뷰 브릿지를 확인하세요.

Did this page help you?
🏠 소스라이브 🎬 소스클립 🔗 소스링크 📢 소스애드
🧩 API 가이드
🆕 최근 업데이트
💬 도움이 더 필요하신가요?
메일로 문의 카카오톡 채널로 문의
담당자에게 문의하기

궁금한 점이나 불편했던 점을 남겨주시면 담당자가 확인 후 답변드릴게요.

가이드 챗봇
* AI를 활용해 답변해서 사실과 다를 수도 있어요. 더 궁금한 사항은 '담당자에게 문의하기'를 이용해주세요.
💡 궁금한 솔루션(예: 라이브, 링크 등)을 함께 적어주시면 더 정확한 답변을 받을 수 있어요.