5. 상품 클릭 관리
시청자가 장바구니를 누르면 onCart 로 상품 ID 가, 상품을 눌러 구매 페이지로 이동할 때는 onProductClick 으로 주소가 전달됩니다. 콜백을 등록하지 않으면 아무 동작도 하지 않습니다.
▲ 상품 목록과 장바구니 버튼이 보이는 플레이어 화면
상품 클릭의 두 가지 동작
상품 영역에서 일어나는 일은 두 갈래입니다.
둘 다 앱이 콜백으로 받아 처리하며, 등록하지 않으면 아무 동작도 하지 않습니다.
배너는 성격이 달라 별도 콜백으로 옵니다.
| 시청자 동작 | 등록하지 않으면 | 등록하면 |
|---|---|---|
| 상품을 눌러 구매 페이지로 이동 |
아무 동작도 하지 않습니다 | onProductClick 으로 주소를 받아 앱 화면에서 처리합니다 |
| 장바구니 담기 | 아무 동작도 하지 않습니다 | onCart 로 상품 ID 를 받아 앱의 장바구니에 담습니다 |
연동하기
앱 전체 콜백으로 받습니다.
등록 방식은 Event handler 에 정리되어 있습니다.
Swift
extension AppDelegate: LivePlayerCallback { func onProductClick(info: ProductClickInfo) -> Bool { openProductScreen(info.url) // info.url = 구매 페이지 주소, info.productId = 상품 ID return true // 앱이 처리했음. false 면 플레이어는 아무 동작도 하지 않습니다 } func onCart(productId: String) { guard !productId.isEmpty else { return } addToCart(productId) } }
| 콜백 | 전달값 | 설명 |
|---|---|---|
onProductClick | ProductClickInfo | url — 이동할 구매 페이지 주소productId — 어드민에 등록한 상품 IDisAppScheme · placement |
onCart | String | 어드민에 등록한 상품 ID. 비어 있을 수 있습니다 |
📘 콜백을 등록하지 않으면 이동하지 않습니다. 앱 안에서 처리하려면
onProductClick 을 등록하세요.
📘 앱 안에서 구매까지 이어갈 수 있습니다. 시청자가 앱을 벗어나지 않으므로 이탈이 줄고, 로그인 상태·장바구니를 그대로 쓸 수 있습니다.
배너 클릭 연동하기
상단 배너와 슬롯 배너는 상품과 다른 콜백으로 옵니다.
어드민에 등록할 때 열림 방식을 함께 정하고, 그 값이 targetType 으로 전달됩니다.
Swift
func onBannerClick(info: BannerClickInfo) -> Bool { // info.url · info.bannerId · info.placement · info.targetType (.self / .blank) openInAppBrowser(info.url) return true // 앱이 처리했음 }
| 전달값 | 설명 |
|---|---|
info.url | 이동할 주소 |
info.bannerId | 어드민에 등록한 배너 식별자 |
info.placement | 눌린 위치 — 상단 배너인지 슬롯 배너인지 |
info.targetType | .self 또는 .blank. 어드민에서 정한 열림 방식입니다 |
info.isAppScheme | 주소가 앱 스킴이면 true |
📘 등록하지 않으면
targetType 에 따라 갈립니다. .blank 는 외부로 열리고, .self 는 아무 동작도 하지 않습니다. 두 경우 모두 앱 안에서 처리하려면 콜백을 등록하고 true 를 돌려줍니다.
전달되는 상품 ID 확인하기
onCart 로 오는 값은 어드민에 등록한 상품 ID 그대로입니다.
자사몰의 상품 코드와 일치해야 장바구니에 담을 수 있습니다.
⚠️ 비어 있을 수 있습니다. 어드민에 상품 ID 를 넣지 않은 상품은 빈 문자열이 옵니다. 담기 전에 값이 있는지 확인하세요.
요청할 수 있는 설정
상품 영역의 표시 방식은 방송 설정으로 제어됩니다. 앱 코드로 바꿀 수 없습니다.
| 설정 | 기본 동작 | 바꾸면 달라지는 것 |
|---|---|---|
| 상품 목록 표시 방식 | 목록형 | 격자형으로 바꿔 한 화면에 더 많은 상품을 보여줍니다 |
| 구매 버튼 표시 | 사용 안 함 | 상품마다 구매 버튼을 항상 노출합니다 |
| 찜한 상품 | 사용 안 함 | 시청자가 상품을 찜할 수 있습니다. 회원만 사용할 수 있으며 게스트 채팅을 허용한 방송에서는 동작하지 않습니다 |
Updated 5 days ago
Did this page help you?
