GuidesAPI GuideChangelog
Log In
Guides

링크 버튼 연동

클립에 등록한 링크 버튼을 클릭했을 때 전송됩니다. 정의하지 않으면 플레이어가 어드민에 설정한 방식대로 링크를 엽니다.

링크 버튼 연동 — 소스클립 플레이어
예상 소요 시간: 10분
🔧 필수/선택: 선택 — 정의하지 않으면 설정한 방식으로 링크 열기
sauceclipMoveLinkButton

클립 정보 영역의 링크 버튼을 클릭하면 전송됩니다.

필드타입설명
linkUrlString어드민에 등록한 링크 주소
clipIdxString클립 ID
📍 버튼은 어드민에서 클립마다 설정합니다. 사용 여부 · 링크 주소 · 버튼 문구 · 배경색 · 이동 방식이 설정 항목이고, 사용으로 설정하고 주소를 등록한 클립에서만 노출됩니다. 자사몰에서 버튼을 띄우거나 감추는 방법은 없습니다.

버튼 노출 위치

상품 프리뷰 형태에 따라 두 가지 모양으로 나타납니다.

상품 프리뷰노출 위치
뱃지형상품 뱃지 목록의 맨 앞 항목
그 외클립 정보 영역 아래 배너
📍 배너형은 플로팅 모드와 진행 바 조작 중에는 노출되지 않습니다. 뱃지형은 상품이 없는 클립에서도 노출됩니다.

구현
javascript
window.sauceclipMoveLinkButton = function (params) {
  window.open(params.linkUrl, '_blank')
}
📍 정의하면 어드민의 이동 방식 설정은 적용되지 않습니다. 현재 창 이동과 새 창 열기 중 무엇으로 처리할지는 이 함수가 정합니다.

정의하지 않았을 때

어드민의 이동 방식 설정에 따라 플레이어가 linkUrl 로 현재 창을 이동시키거나 새 창을 엽니다.

⚠️ iframe 구성에서는 이 이벤트가 전송되지 않습니다. 부모 창으로 message 가 가지 않고 플레이어가 iframe 안에서 링크를 엽니다. 다른 브릿지 이벤트와 다른 점입니다. 제약은 iframe 연동에 있습니다.

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

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

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