로딩중입니다
쿠폰 연동 : 안드로이드
3/4/2015 10:48:56 AM

쿠폰 서비스

쿠폰 서비스는 IGAW 쿠폰 서비스에서 발급한 쿠폰을 유저가 입력하였을 때, 리워드를 유저에게 지급하는 서비스입니다. 

쿠폰 서비스에 대한 자세한 설명은 아래 링크에서 확인할 수 있습니다.

[쿠폰 서비스 안내]


주의사항
  1. 쿠폰 애드온을 연동하기 전에 반드시 IGAW 공통 연동이 진행 되어야 합니다. [IGAW 공통 연동 : 안드로이드]
  2. 쿠폰 연동을 위해서는 IgawCoupon~*.jar 파일이 안드로이드 프로젝트에 포함되어 있어야 합니다. [SDK 설치 : 안드로이드]



쿠폰 API

쿠폰 서비스를 이용하기 위해서 다음의 API 들을 이용하여 연동을 진행합니다.


유저식별값 입력

유저식별값은 캠페인을 완료한 유저를 식별하여 리워드를 지급하기 위해 사용되는 정보입니다.

유저식별값은 반드시 유저가 쿠폰 번호를 입력하기 전에 설정되어야 합니다.


    주의 사항

  1. 1명의 유저는 1개의 고유한 유저식별값을 가져야하며, 가변적인 값을 사용해서는 안됩니다.
  2. 개인정보(이메일, 이름, 전화번호, 식별가능한 유저아이디 등)이 포함되어서는 안됩니다.
  3. 한글, 특수문자, 공백 등이 포함된 경우에는 반드시 URL 인코딩 처리를 하여 사용하여야 합니다.
  4. 유저가 쿠폰 번호를 입력하기 전에 설정되어야 합니다.

위 주의사항에 유의하여 유저 식별값을 입력합니다.

IgawCommon.setUserId(getApplicationContext(),"user10001");

  


쿠폰 노출

유저가 쿠폰 번호를 입력할 수 있는 UI가 필요합니다. 쿠폰 번호 입력창을 구성하는 방법은 다음과 같습니다.

  • 쿠폰 SDK 이용
  • 직접 구성

쿠폰SDK에서 제공하는 UI를 사용하는 방법과 직접 구성한 UI를 사용하는 방법이 있으며, 각 방법에 따라 다음과 같이 연동을 진행합니다.


쿠폰 SDK 이용 시

showCouponDialog API를 호출하여 입력창을 노출하며 각 파라미터에 대한 설명과 사용 예시는 다음과 같습니다.

  • showResultToast : 쿠폰 사용 결과 메시지를 Toast로 노출할 것인지 여부, true or false
  • ValidationResultModel  : showResultToast를 false로 설정하였을 때, ValidationResultModel 타입의 ValidationResultModel[i] 배열로 전달되며, 배열에 포함된 정보는 다음과 같습니다.   
    • ValidationResultModel.getResult() : 쿠폰 사용 결과
    • ValidationResultModel.getMessage() : 쿠폰 사용 결과 메시지
    • ValidationResultModel.getItemKey() : 쿠폰 아이템 키
    • ValidationResultModel.getItemName() : 쿠폰 아이템 이름
    • ValidationResultModel.getQuantity() : 유저에게 지급해야 할 가상화폐의 양
 IgawCoupon.showCouponDialog(MainActivity.this, false, new CouponCallbackListener() {
            
	@Override
	public void run(Dialog dialog, ValidationResultModel CouponResult) {

	//showResultMsgToast 를 false로 했을 경우 이 곳으로 쿠폰 사용 결과가 리턴됩니다.
	//쿠폰 사용 후 실행할 액션(ex. 아이템 확인 공지 노출, 상점 이동, 아이템 목록 갱신)
	Log.d(tag, "showCouponDialog.Result ::: " + CouponResult.getResult());
	Log.d(tag, "showCouponDialog.Message ::: " + CouponResult.getMessage());
	Log.d(tag, "showCouponDialog.ItemKey ::: " + CouponResult.getItemKey());
	Log.d(tag, "showCouponDialog.ItemName ::: " + CouponResult.getItemName());
	Log.d(tag, "showCouponDialog.Quantity ::: " + CouponResult.getQuantity());

	}
});


직접 구성 UI 이용 시

checkCoupon API를 이용하여 유저가 입력한 쿠폰 번호를 파라미터로 전달하고 그 결과를 리턴 받습니다.

아래 예시의 {쿠폰번호} 부분에 유저가 입력한 쿠폰 번호를 String으로 전달합니다.

IgawCoupon.checkCoupon(YourActivity.this, "{쿠폰번호}", new CouponCallbackListener() {

	@Override
	public void run(Dialog dialog, ValidationResultModel CouponResult) {

	//showResultMsgToast 를 false로 했을 경우 이 곳으로 쿠폰 사용 결과가 리턴됩니다.
	//쿠폰 사용 후 실행할 액션(ex. 아이템 확인 공지 노출, 상점 이동, 아이템 목록 갱신)
	Log.d(tag, "showCouponDialog.Result ::: " + CouponResult.getResult());
	Log.d(tag, "showCouponDialog.Message ::: " + CouponResult.getMessage());
	Log.d(tag, "showCouponDialog.ItemKey ::: " + CouponResult.getItemKey());
	Log.d(tag, "showCouponDialog.ItemName ::: " + CouponResult.getItemName());
	Log.d(tag, "showCouponDialog.Quantity ::: " + CouponResult.getQuantity());

	}
});



IGAW 리워드 서버 연동

쿠폰을 입력한 유저들에게 리워드를 지급하기 위하여 반드시 IGAW리워드 서버와의 연동이 필요합니다.

쿠폰 서비스에서는 자세 서버를 통한 리워드서버 연동방식만을 지원합니다.

IGAW 리워드 서버 연동에 대한 것은 아래 링크에서 확인할 수 있습니다.

[IGAW 리워드 서버 연동 가이드]