GuidesAPI GuideChangelog
Log In
Guides

5. 상품 클릭 관리

시청자가 장바구니를 누르면 onCart 로 상품 ID 가, 상품을 눌러 구매 페이지로 이동할 때는 onProductClick 으로 주소가 전달됩니다. 콜백을 등록하지 않으면 아무 동작도 하지 않습니다.

5. 상품 클릭 관리 — 소스라이브 플레이어 iOS SDK
예상 소요 시간: 10분
📋 사전 조건: 2. 플레이어 실행하기
상품 목록과 장바구니 버튼이 있는 상품 패널
▲ 상품 목록과 장바구니 버튼이 보이는 플레이어 화면
상품 클릭의 두 가지 동작

상품 영역에서 일어나는 일은 두 갈래입니다.
둘 다 앱이 콜백으로 받아 처리하며, 등록하지 않으면 아무 동작도 하지 않습니다.
배너는 성격이 달라 별도 콜백으로 옵니다.

시청자 동작등록하지 않으면등록하면
상품을 눌러
구매 페이지로 이동
아무 동작도 하지 않습니다 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)
    }
}
콜백전달값설명
onProductClickProductClickInfourl — 이동할 구매 페이지 주소
productId — 어드민에 등록한 상품 ID
isAppScheme · placement
onCartString어드민에 등록한 상품 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 를 넣지 않은 상품은 빈 문자열이 옵니다. 담기 전에 값이 있는지 확인하세요.
요청할 수 있는 설정

상품 영역의 표시 방식은 방송 설정으로 제어됩니다. 앱 코드로 바꿀 수 없습니다.

설정기본 동작바꾸면 달라지는 것
상품 목록 표시 방식목록형격자형으로 바꿔 한 화면에 더 많은 상품을 보여줍니다
구매 버튼 표시사용 안 함상품마다 구매 버튼을 항상 노출합니다
찜한 상품사용 안 함시청자가 상품을 찜할 수 있습니다. 회원만 사용할 수 있으며 게스트 채팅을 허용한 방송에서는 동작하지 않습니다
📘 설정 변경 문의모비두 담당자 또는 카카오톡 채널로 요청하세요.


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

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

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