A. 쿠폰 사용하기
쿠폰은 타입에 따라 앱이 할 일이 다릅니다. custom 타입일 때만 onCouponEvent 로 링크가 전달되고, 나머지는 플레이어가 자체 처리합니다.
▲ 쿠폰 받기 버튼이 뜬 플레이어 화면
쿠폰 타입에 따라 앱이 할 일이 다릅니다
쿠폰은 어드민에서 타입을 정해 등록합니다.
대부분은 플레이어가 자체 처리하고, 앱이 받는 것은 한 가지 경우입니다.
| 타입 | 시청자가 누르면 | 앱이 할 일 |
|---|---|---|
link | 플레이어가 링크를 같은 화면에서 엽니다 | 없음 |
newwindow | 플레이어가 링크를 새 창으로 엽니다 | 없음 |
download · apiDownload | 플레이어가 발급 처리하고 사용됨 표시로 바꿉니다 | 없음 |
custom | 발급 처리 후 onCouponEvent 로 앱에 전달합니다 | 있음 — 아래 참고 |
✅
custom 을 쓰지 않는다면 연동할 코드가 없습니다 — 쿠폰 기능 자체는 플레이어를 띄운 것만으로 동작합니다.
custom 타입 처리하기
시청자가 custom 쿠폰을 누르면 어드민에 등록된 링크 주소가 콜백으로 전달됩니다.
그 주소로 무엇을 할지는 앱이 정합니다.
Swift
player.onCouponEvent = { [weak self] linkUrl in
guard let linkUrl = linkUrl, !linkUrl.isEmpty else { return }
// 앱 안의 쿠폰함으로 보내거나, 자사 API 를 호출하거나…
self?.handleCoupon(linkUrl)
}
| 전달값 | 타입 | 설명 |
|---|---|---|
linkUrl | String? | 어드민에 등록한 링크 주소가 그대로 전달됩니다.nil 이거나 빈 문자열일 수 있으므로 반드시 확인하세요 |
⚠️ 형식이 정해져 있지 않습니다. 어드민에 입력한 값이 그대로 전달됩니다. URL 이 아닌 값도 올 수 있으므로 앱에서 검증한 뒤 사용하세요. 어떤 형식으로 등록할지는 담당자와 미리 정해 두는 편이 안전합니다.
💡 발급 처리는 이미 끝난 상태입니다. 콜백이 오는 시점에 플레이어는 쿠폰을 「사용됨」으로 표시하고 단말에 기록해 둡니다. 앱이 발급 자체를 처리할 필요는 없습니다.
알아 둘 것
💡 Android 와 콜백 구조가 다릅니다 — Android 는 다운로드형과
custom 을 서로 다른 두 콜백으로 받지만, iOS 는 onCouponEvent 하나입니다. 두 플랫폼에서 같은 동작을 만들려면 분기 코드가 달라집니다.
Updated about 1 hour ago
Did this page help you?