상품 클릭 연동
플레이어에서 상품을 클릭하면 소스라이브 플레이어 웹 SDK가 productClick 이벤트를 전송합니다. 등록하지 않으면 웹 SDK가 상품 페이지로 이동하고, 이벤트를 등록하면 새 창 열기, 상품 코드 기반 라우팅 등 자사몰에 맞는 동작을 정의할 수 있습니다.
▲ 플레이어의 상품 목록 — 상품을 클릭하면 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 등록: 어드민에서 상품을 추가할 때 자사몰 상품 코드를 외부 상품 코드 필드에 입력하세요.
📘 앱 웹뷰에서 플레이어를 열 때는 앱 웹뷰 브릿지를 확인하세요.
Updated 4 days ago
Did this page help you?
