GuidesAPI GuideChangelog
Log In
Guides

상품 클릭 연동

플레이어에서 상품을 클릭하면 소스라이브 플레이어 웹 SDK가 productClick 이벤트를 전송합니다. 등록하지 않으면 웹 SDK가 상품 페이지로 이동하고, 이벤트를 등록하면 새 창 열기, 상품 코드 기반 라우팅 등 자사몰에 맞는 동작을 정의할 수 있습니다.

상품 클릭 연동 — 소스라이브 플레이어
⏱ 예상 소요 시간: 15분
📋 사전 조건: 브릿지 이벤트 연동 완료
상품 목록과 구매 버튼이 열린 플레이어 화면
▲ 플레이어의 상품 목록 — 상품을 클릭하면 productClick 이벤트가 전송됩니다
이벤트 데이터

productClick 처리 함수의 이벤트 값에 아래 필드가 전달됩니다. 앱스킴 필드는 브릿지 이벤트 레퍼런스에 있습니다.

필드 타입 필수 설명
linkUrl String | null 필수 어드민에 등록된 상품 페이지 링크 URL
broadcastId String 필수 라이브 ID
price Number | String | null 필수 상품 가격
externalProductId String | null 필수 어드민에 등록한 외부 상품 코드. 등록하지 않은 상품은 null
isSoldout Boolean 필수 품절 여부
구현 방법

자사몰의 상품 이동 방식에 맞는 탭을 선택하세요.

📘 방식 선택 기준
단순한 쇼핑몰이라면 현재 창 이동을 선택하고 productClick은 등록하지 않는 것을 권장합니다. 라이브를 보면서 상품을 구경하게 하려면 새 창 열기를 선택하세요. 자사몰의 라우팅 URL 체계가 있고 어드민에 외부 상품 코드를 등록했다면 상품 코드 기반 라우팅이 가장 유연합니다.

등록 여부
새 창 열기나 상품 코드 기반 라우팅으로 직접 처리할 때 productClick을 등록하세요. 등록하면 플로팅 이어 보기는 동작하지 않습니다.
현재 창에서 상품 페이지로 이동합니다. 어드민에 등록된 linkUrl을 그대로 사용합니다.
productClick을 등록하지 않으면 웹 SDK가 이 이동을 처리합니다. 같은 자사몰 안의 주소면 모달·전체화면의 플레이어를 플로팅으로 줄여 이어 재생합니다(예정 방송 제외).
새 창(탭)에서 상품 페이지를 엽니다. 라이브 시청을 끊지 않고 상품을 확인할 때 유용합니다.
JavaScript
SauceLive.Player('on', 'productClick', (e) => {
  if (!e.linkUrl) return
  // 새 창(탭)에서 상품 페이지 열기
  window.open(e.linkUrl, '_blank')
})
자사몰의 상품 코드(externalProductId)를 기반으로 원하는 URL을 직접 구성합니다.
JavaScript
SauceLive.Player('on', 'productClick', (e) => {
  // externalProductId가 없으면 처리하지 않음
  if (!e.externalProductId) return
  // 상품 코드를 이용해 자사몰 URL 구성
  location.href = `/products/${e.externalProductId}`
})
📘 품절 상품 처리: 품절 상품의 클릭을 막으려면 처리 함수 첫 줄에 if (e.isSoldout) return을 추가하세요.
조건 분기 처리 예시

externalProductId가 있으면 자사몰 라우팅을, 없으면 linkUrl로 폴백하는 방어적 패턴입니다. 상품 코드 기반 라우팅을 쓸 때는 이 형태로 등록하세요.

JavaScript — 조건 분기 + 폴백
SauceLive.Player('on', 'productClick', (e) => {
  // 품절 상품 클릭 시 얼리 리턴. 안내는 showToast 명령으로 플레이어 안에 표시
  if (e.isSoldout) {
    SauceLive.Player('showToast', '현재 품절된 상품입니다.')
    return
  }

  // externalProductId가 있으면 자사몰 라우팅 우선
  if (e.externalProductId) {
    location.href = `/products/${e.externalProductId}`
  } else if (e.linkUrl) {
    // 없으면 어드민 등록 linkUrl로 폴백
    location.href = e.linkUrl
  }
})
📌 externalProductId 등록: 어드민에서 상품을 추가할 때 자사몰 상품 코드를 외부 상품 코드 필드에 입력하세요.
📘 앱 웹뷰에서 플레이어를 열 때는 앱 웹뷰 브릿지를 확인하세요.

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

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

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