브릿지 이벤트 레퍼런스

브릿지 이벤트 레퍼런스 — 쇼룸 WEB

📖 레퍼런스

🔀 전송 7종 · 콜백 2종

구현 위치

쇼룸 라이브러리를 넣은 페이지가 최상위인지 iframe 안인지에 따라 구현 위치와 받는 값이 달라집니다.

	동일 페이지	부모 페이지 (iframe)
언제	라이브러리를 넣은 페이지에서 직접 처리	라이브러리를 넣은 페이지를 `iframe` 으로 띄우는 경우
구현 대상	`window.sauceShowroom` 객체에 함수 정의	`message` 이벤트 리스너
받는 값	페이로드 JSON 문자열	`{ key, params }` JSON 문자열
파싱	`JSON.parse(jsonStr)`	`JSON.parse(e.data).params` — `params` 는 객체
필수 여부	선택	필수 — iframe 안에서는 동일 페이지 정의가 호출되지 않습니다

📌 전송 우선순위는 Android 웹뷰 → iOS 웹뷰 → iframe → 동일 페이지입니다. 자세한 내용은 브릿지 이벤트 연동에 있습니다.

💡 모든 페이로드에 partnerUniqueId 가 포함됩니다. 파싱 실패를 대비해 try·catch 로 감싸고, 실패 시 이동을 중단합니다.

이동 이벤트

sauceShowroomMoveBanner

필드	타입	설명
bannerId	String	배너 ID
bannerTypeCode	String	`'IMAGE'` 이미지 배너 · `'STRIP'` 띠 배너 · `'LIVE'` 라이브 배너
linkTypeCode	String	`'URL'` 웹 URL · `'APP_SCHEME'` 앱 스킴 · `'NONE'` 링크 없음
linkUrl	String	이동할 URL. 모바일에서 배너에 앱 스킴이 설정돼 있으면 앱 스킴 값
linkUrlTargetTypeCode	String	`'SELF'` 현재 창 · `'BLANK'` 새 창. 값이 없을 수 있습니다
partnerUniqueId	String	파트너 ID

sauceShowroomMoveProduct

sauceShowroomMoveSauceLivePlayer

필드	타입	설명
broadcastId	String	라이브 ID
broadcastUrl	String	라이브 플레이어 URL
vodCurationId	String	VOD 큐레이션에서 클릭한 경우의 큐레이션 ID. 그 밖에는 포함되지 않습니다
partnerUniqueId	String	파트너 ID

sauceShowroomMoveSauceClipPlayer

알림 이벤트

받기와 해제의 페이로드는 같습니다.

sauceShowroomTurnOnNotification
sauceShowroomTurnOffNotification

로그인 이벤트

sauceShowroomMemberLogin

필드	타입	설명
—	—	페이로드가 없습니다

콜백 이벤트

자사몰이 쇼룸으로 회신하는 이벤트입니다. 전송 방향이 반대입니다.

sauceShowroomTurnOnNotificationCallback
sauceShowroomTurnOffNotificationCallback

필드	타입	필수	설명
broadcastId	String	필수	알림을 처리한 라이브 ID. 요청한 라이브 ID와 일치할 때만 성공으로 판정합니다

구현 위치	회신 방법
동일 페이지	`window.sauceShowroom.sauceShowroomTurnOnNotificationCallback({ broadcastId })` 인자는 객체
부모 페이지 (iframe)	`iframe.contentWindow.postMessage(JSON.stringify({ key, params: { broadcastId } }), '*')`

💡 콜백 대기 시간은 5초입니다. 자세한 흐름은 라이브 알림 연동에 있습니다.