5단계 쿠폰 사용하기

    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
        )
    }


    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
        )
    }