로딩중입니다
쿠폰 연동 : iOS
3/6/2015 5:40:09 PM

쿠폰 서비스

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

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

[쿠폰 서비스 안내]


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



쿠폰 API

쿠폰 서비스를 이용하기 위해서 IgaworksCore.hIgaworksCoupon.h 파일을 import 하여 사용합니다.


유저식별값 입력

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

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


    주의 사항

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

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

[IgaworksCore setUserId:@"user10001"];



쿠폰 노출

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

  • 쿠폰 SDK 이용
  • 직접 구성

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


쿠폰 SDK 이용 시

showCoupon API를 호출하여 입력창을 노출합니다.
#import <IgaworksCoupon/IgaworksCoupon.h>

- (void)couponInputBoxClickActionSample {
    [IgaworksCoupon showCoupon];
}
 

직접 구성 UI 이용 시

checkCoupon API를 호출하여 유저가 입력한 쿠폰 번호를 파라미터로 전달하고 그 결과를 리턴 받습니다.
아래 예시의 @"쿠폰번호" 부분에 유저가 입력한 쿠폰 번호를 NSString 으로 전달합니다.
#import <IgaworksCoupon/IgaworksCoupon.h>

- (void)customCouponInputBoxActionSampleWithCouponText{
    [IgaworksCoupon checkCoupon:@"쿠폰번호"];
}


쿠폰 델리게이트

쿠폰 서비스에서는 델리게이트를 제공하여 쿠폰 사용이 완료 되었을 경우에 별도의 액션을 정의하여 사용할 수 있습니다.

델리게이트 등록

쿠폰 델리게이트를 사용하기 위해서는 아래와 같이 델리게이트를 등록해야 합니다.
[IgaworksCoupon shared].delegate = self;

델리게이트 구현

쿠폰 사용이 완료 되었을 때, 결과를 전달합니다.
- (void)igaworksCouponValidationDidComplete:(BOOL)result message:(NSString *)message{
	NSLog(@"- (void)igaworksCouponValidationDidComplete:(BOOL)result message:(NSString *)message : %d, %@", result, message);
}


IGAW 리워드 서버 연동

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

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

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

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