5. 상품 클릭 관리
시청자가 장바구니를 누르면 onCart 로 상품 ID 가, 상품·배너를 눌러 구매 페이지로 이동할 때는 onProductClick 으로 주소가 전달됩니다. 콜백을 등록하지 않으면 외부 브라우저로 열립니다.
▲ 상품 목록과 장바구니 버튼이 보이는 플레이어 화면
상품 클릭의 두 가지 동작
상품 영역에서 일어나는 일은 두 갈래입니다.
둘 다 콜백 등록은 선택이고, 등록하지 않으면 플레이어가 기본 동작으로 처리합니다.
| 시청자 동작 | 등록하지 않으면 | 등록하면 |
|---|---|---|
| 상품·배너를 눌러 구매 페이지로 이동 |
외부 브라우저로 열립니다 | 선택onProductClick 으로 주소를 받아 앱 화면에서 처리합니다 |
| 장바구니 담기 | 플레이어가 자체 처리합니다 | 선택onCart 로 상품 ID 를 받아 앱의 장바구니에 담습니다 |
연동하기
플레이어 인스턴스에 클로저를 대입합니다.
startPlayer() 를 호출하기 전에 등록하세요.
Swift
// 구매 페이지로 이동 — 앱 안에서 처리하고 싶을 때만 player.onProductClick = { [weak self] linkUrl in guard let url = linkUrl else { return } self?.openProductScreen(url) } // 장바구니 담기 player.onCart = { [weak self] productId in guard let id = productId else { return } self?.addToCart(id) } player.startPlayer()
| 콜백 | 전달값 | 설명 |
|---|---|---|
onProductClick | String? | 이동할 구매 페이지 주소. 어드민에 등록한 값입니다 |
onCart | String? | 어드민에 등록한 상품 ID. 비어 있을 수 있습니다 |
💡 등록은 선택입니다. 콜백을 두지 않으면 구매 페이지는 외부 브라우저로 열리고 장바구니는 플레이어가 처리합니다. 그대로도 구매는 이어지므로, 앱 안에서 처리하고 싶을 때만 등록하세요.
✅ 앱 안에서 구매까지 이어갈 수 있습니다. 시청자가 앱을 벗어나지 않으므로 이탈이 줄고, 로그인 상태·장바구니를 그대로 쓸 수 있습니다.
전달되는 상품 ID 확인하기
onCart 로 오는 값은 어드민에 등록한 상품 ID 그대로입니다.
자사몰의 상품 코드와 일치해야 장바구니에 담을 수 있습니다.
⚠️ 비어 있을 수 있습니다. 어드민에 상품 ID 를 넣지 않은 상품은 빈 문자열이 옵니다. 담기 전에 값이 있는지 확인하세요.
Updated about 1 hour ago
Did this page help you?