A. 쿠폰 사용하기
쿠폰은 타입에 따라 앱이 할 일이 다릅니다. download·custom 타입은 콜백으로 전달되고, link·newWindow 는 앱이 처리하지 않으면 플레이어가 엽니다.
▲ 쿠폰 받기 버튼이 뜬 플레이어 화면
쿠폰 타입에 따라 앱이 할 일이 다릅니다
쿠폰은 어드민에서 타입을 정해 등록합니다.
apiDownload 를 뺀 나머지는 모두 콜백으로 전달됩니다.
| 타입 | 시청자가 누르면 | 앱이 할 일 |
|---|---|---|
download | 쿠폰 코드를 앱에 전달합니다 | 있음 — onCouponDownload 에서 발급 처리 |
custom | 등록해 둔 데이터를 앱에 전달합니다 | 있음 — onCouponCustom 에서 자체 규칙으로 처리 |
link · newWindow | 앱이 처리하지 않으면 등록된 주소를 엽니다 | 선택 — onCouponLinkClick 을 등록하면 앱 안에서 열 수 있습니다 |
apiDownload | 플레이어가 발급 처리하고 사용됨 표시로 바꿉니다 | 없음 |
📘 타입은 어드민에서 정합니다. 앱 코드로 바꿀 수 없습니다. 어떤 타입으로 운영할지 먼저 정한 뒤 그에 맞는 준비를 하세요.
download·custom 타입 처리하기
시청자가 쿠폰을 누르면 어드민에 등록한 값이 콜백으로 전달됩니다.
받은 값으로 무엇을 할지는 앱이 정합니다.
Swift
func onCouponDownload(couponCode: String) { // couponCode = 어드민에 등록한 쿠폰 코드. 자사 쿠폰 시스템에 발급 요청 } func onCouponCustom(metaData: String) { // metaData = 어드민에 등록한 문자열. 형식은 운영 정책에 따라 }
| 전달값 | 타입 | 설명 |
|---|---|---|
couponCode | String | 어드민에 등록한 쿠폰 코드 |
metaData | String | 어드민에 등록한 데이터 문자열. 형식이 정해져 있지 않습니다 |
⚠️
metaData 의 형식은 정해져 있지 않습니다. 어드민에 입력한 값이 그대로 전달됩니다. JSON 으로 쓸지 단순 문자열로 쓸지 운영 담당자와 형식을 먼저 합의하고, 파싱 실패에 대비하세요.
나머지 두 타입
아래 두 타입은 앱 코드 없이도 동작합니다. 다만 준비가 필요한 경우가 있습니다.
📘
link · newWindow — onCouponLinkClick 을 등록하지 않으면 등록된 주소가 외부로 열립니다. 앱 안에서 열려면 콜백을 등록하고 true 를 돌려줍니다.
📘
apiDownload — 플레이어가 등록된 주소를 직접 호출해 쿠폰 발급을 요청합니다. 앱 코드는 필요 없지만 자사 서버에 발급 API 를 준비해야 합니다. 요청 형식은 담당자에게 확인하세요.
Updated 5 days ago
Did this page help you?