5단계 쿠폰 사용하기

Shoplive Player SDK에 쿠폰 팝업 기능을 연동하기 위한 가이드입니다.

1032

1. LINK / LINK (New window)

쿠폰 클릭 이벤트를 LINK 또는 LINK (New window)로 설정한 경우 쿠폰 연동 방법입니다.


  • handleNavigation

쿠폰 클릭 시 호출되는 콜백 함수입니다. url을 전달받아서 고객사 앱의 로직에 맞게 구현할 수 있습니다.

param설명
url정의된 링크 url입니다.

  • 샘플 코드
override fun handleNavigation(context: Context, url: String) {
  // 링크 이동
  val intent = Intent(this@YourActivity, WebViewActivity::class.java)
  intent.putExtra("url", url)
  startActivity(intent)
}


2. Download coupon

쿠폰 클릭 이벤트를 Download coupon으로 선택한 경우 쿠폰 연동 방법입니다.


  • handleDownloadCoupon

쿠폰 클릭 시 호출되는 콜백 함수입니다. 쿠폰 ID를 전달받아서 고객사 앱의 로직에 맞게 구현할 수 있습니다.

param설명
couponId쿠폰 ID입니다.
callback사용자에게 쿠폰 발행 후, 쿠폰 발행 결과를 Shoplive에 전달하기 위한 객체입니다.

  • 샘플 코드
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
    )
}


3. User define

쿠폰 클릭 이벤트를 User define으로 선택한 경우 쿠폰 연동 방법입니다.
고객사에서 필요한 정보를 JSON 형식으로 정의해 Payload 객체에 추가할 수 있습니다.



  • handleCustomAction

쿠폰 클릭 시 호출되는 콜백 함수입니다. 정의된 정보를 전달받아서 고객사 앱의 로직에 맞게 구현할 수 있습니다.

payload설명
id팝업의 고유 번호입니다.
type팝업의 종류입니다. (COUPON, BANNER, NOTICE)
payload사용자가 정의한 payload data입니다.
callback사용자에게 쿠폰 발행 후, 쿠폰 발행 결과를 Shoplive에 전달하기 위한 객체입니다.

  • 샘플 코드
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
    )
}