이벤트 제어를 위한 messageCallback
샵라이브에서 제공하는 플레이어의 Init() 수행시 messageCallback 정의를 통해 쿠폰 다운로드, 상품 클릭과 같이 미리 정해진 action에 대한 정의를 할 수 있고 고객사 별로 커스텀 액션을 정의할 수도 있습니다.
- 쿠폰기능 연동을 위한 상세 가이드는 쿠폰 연동하기 를 참고하세요
- 상품 클릭 동작 제어를 위한 상세 가이드는 상품 클릭 동작 제어 를 참고하세요
- 로그인이 필요한 기능에 접근한 비로긴 유저의 동작을 정의하기 위한 상세 가이드는 로그인이 필요한 기능 접근시 콜백 동작 제어 를 참고하세요
messageCallback
| action | payload | 설명 |
|---|---|---|
| LOGIN_REQUIRED | campaignKey (string) | Guest로 플레이어를 실행한 상태에서 플레이어에서 로그인 정보가 필요한 경우 호출됩니다. (예, Guest로 라이브 시청 중 채팅 버튼을 클릭할 경우) 로그인 화면으로 이동하는 코드를 삽입하여 사용할 수 있습니다. |
| DOWNLOAD_COUPON | coupon (string) type(string) | 팝업(배너, 쿠폰, 공지)을 클릭할 때 타입과 함께 설정해놓은 값을 전달합니다. type (발생 타입) - BANNER, COUPON, NOTICE |
| CLICK_PRODUCT | Goods | 상품 정보가 클릭되었을 경우 호출됩니다. 상품 상세 페이지 이동을 위한 URL을 받아서 별도의 처리가 필요한 경우 활용할 수 있습니다. * CLICK_PRODUCT을 별도로 처리하지 않아도 플레이어에서 상품을 클릭하면 해당 URL로 이동하도록 되어 있습니다. (새창으로 이동. 만약 현재 창에서 이동하고자 할 경우 아래의 샘플 코드를 참고하시기 바랍니다) |
| CLICK_PRODUCT_CART | Goods | 상품 리스트 내 장바구니 버튼을 클릭했을 경우 호출됩니다. 별도의 처리가 필요한 경우 활용할 수 있도록, 상품의 여러가지 정보가 payload 에 포함됩니다. { "sku" : string, "name": string, "brand": string, "url" : string } |
| LINK | json object {"url": linkUrl} | 팝업(배너, 쿠폰, 공지)에서 클릭 이벤트를 링크로 설정했거나 상품 목록 상단 링크를 클릭할 때 링크 주소와 함께 호출됩니다. 별도로 구현(override)하지 않는 경우 웹에서는 페이지 자체가 이동되며 (현재 라이브 페이지 이탈) 앱(SDK)의 경우 PIP 모드로 진입하고 NAVIGATION이 호출됩니다. |
| LINK_NEW_WINDOW | json object {"url": linkUrl} | 팝업(배너, 쿠폰, 공지)에서 클릭 이벤트를 링크(새창 열기)로 설정했을 때 사용자가 링크를 클릭하면 링크 주소와 함께 호출됩니다. 별도로 구현(override)하지 않는 경우 웹에서는 새창에 linkUrl을 띄우며 앱(SDK)의 경우 PIP 모드로 진입하고 NAVIGATION이 호출됩니다. |
| CLICK_SHARE_BTN | json object | 공유 버튼이 클릭되었을 경우 호출됩니다. 아래와 같은 json object가 payload에 포함됩니다. { "campaignKey" : string, "shareUrl" : string } |
| ON_CLICK_CAMPAIGN_LIST_ITEM | PluginCampaign | 모아보기 방송 목록 중 하나를 클릭했을 때 |
| ON_PLAYER_MODAL_SHOWN | PluginCampaign | 플레이어 모달 UI 가 화면에 표시 되었을 때 |
| ON_PLAYER_MODAL_HIDDEN | PluginCampaign | 플레이어 모달 UI 가 닫히고 화면에서 사라졌을 때 |
| ON_CLICK_CLOSE_PLAYER_MODAL | PluginCampaign | 사용자가 플레이어 모달 UI 의 닫기버튼을 클릭 했을 때 |
| ON_LIVE_MINI_PREVIEW_SHOWN | 없음 | 라이브 방송 배너가 표시 될 때 |
| ON_LIVE_MINI_PREVIEW_HIDDEN | 없음 | 라이브 방송 배너가 화면에서 사라질 때 |
| ON_CLICK_CLOSE_LIVE_MINI_PREVIEW | 없음 | 사용자가 라이브 방송 배너의 닫기 버튼을 클릭했을 때. |
| ON_CLICK_BUY_BUTTON | Goods | 상품 목록의 'Buy' 버튼을 클릭했을 때 |
| ON_PRODUCT_LIST_SHOWN | Array | 상품목록 팝업이 표시될 때 |
Updated 3 months ago