- 인쇄
5단계 쿠폰 사용하기
- 인쇄
Shoplive Player SDK에 쿠폰 팝업 기능을 연동하기 위한 가이드입니다.
LINK / LINK (New window)
쿠폰 클릭 이벤트를 LINK 또는 LINK (New window)로 설정한 경우 쿠폰 연동 방법입니다.
handleNavigation
쿠폰 클릭 시 호출되는 콜백 함수입니다. URL을 전달받아서 고객사 앱의 로직에 맞게 구현할 수 있습니다.
Parameter name | Type | Description |
---|---|---|
url | String | 정의된 링크 url입니다. |
Sample code
override fun handleNavigation(context: Context, url: String) {
// 링크 이동
val intent = Intent(this@YourActivity, WebViewActivity::class.java)
intent.putExtra("url", url)
startActivity(intent)
}
Download coupon
쿠폰 클릭 이벤트를 Download coupon으로 선택한 경우 쿠폰 연동 방법입니다.
handleDownloadCoupon
쿠폰 클릭 시 호출되는 콜백 함수입니다. 쿠폰 ID를 전달받아서 고객사 앱의 로직에 맞게 구현할 수 있습니다.
Parameter name | Type | Description |
---|---|---|
couponId | String | 쿠폰 ID입니다. |
callback | ShopLiveHandlerCallback | 사용자에게 쿠폰 발행 후, 쿠폰 발행 결과를 Shoplive에 전달하기 위한 객체입니다. |
Sample code
override fun handleDownloadCoupon(
context: Context,
couponId: String,
callback: ShopLiveHandlerCallback
) {
// couponResult의 파라미터는 아래 API Reference 링크를 통해 확인할 수 있습니다.
callback.couponResult(
isDownloadSuccess = true,
message = "Coupon download success!",
couponStatus = ShopLive.CouponPopupStatus.HIDE,
alertType = ShopLive.CouponPopupResultAlertType.ALERT
)
}
API Reference: Coupon, ShopLiveHandler.handleDownloadCoupon
User define
쿠폰 클릭 이벤트를 User define으로 선택한 경우 쿠폰 연동 방법입니다. 고객사에서 필요한 정보를 jSON
형식으로 정의해 Payload 객체에 추가할 수 있습니다.
handleCustomAction
쿠폰 클릭 시 호출되는 콜백 함수입니다. 정의된 정보를 전달받아서 고객사 앱의 로직에 맞게 구현할 수 있습니다.
Parameter name | Type | Description |
---|---|---|
id | String | 팝업의 고유 번호입니다. |
type | String | 팝업의 종류입니다. (COUPON, BANNER, NOTICE) |
payload | String | 사용자가 정의한 payload data입니다. |
callback | ShopLiveHandlerCallback | 사용자에게 쿠폰 발행 후, 쿠폰 발행 결과를 Shoplive에 전달하기 위한 객체입니다. |
Sample code
override fun handleCustomAction(
context: Context,
id: String,
type: String,
payload: String,
callback: ShopLiveHandlerCallback) {
// customActionResult의 파라미터는 아래 API Reference 링크를 통해 확인할 수 있습니다.
callback.customActionResult(
isSuccess = true,
message = "success!",
couponStatus = ShopLive.CouponPopupStatus.HIDE,
alertType = ShopLive.CouponPopupResultAlertType.ALERT
)
}
API Reference: ShopLiveHandler.handleCustomAction