쿠폰 지급 구현 순서
쿠폰으로 사용자에게 아이템을 지급하려면 쿠폰과 우편함을 함께 구현해야 합니다. '쿠폰'은 쿠폰에 설정한 아이템을 담은 지급 우편을 사용자의 앱 내 우편함으로 보낼 뿐이고, 사용자는 그 우편함에서 아이템을 받기 때문입니다.
모듈 설치, 초기화, 로그인을 마쳤다면 아래 순서로 쿠폰 지급 기능을 완성하세요.
1. 지급할 아이템과 쿠폰 준비
앱 클라이언트가 쿠폰 사용을 요청하려면 사용자가 입력할 쿠폰 코드가 있어야 합니다. 따라서 운영자는 Hive 콘솔에서 쿠폰으로 지급할 아이템과 쿠폰을 아래 순서로 먼저 준비합니다.
- 아이템 등록에서 쿠폰으로 지급할 아이템을 등록합니다.
- 쿠폰 발행에서 쿠폰 종류, 사용 기간, 지급 아이템과 수량을 정해 발행을 요청합니다.
- 쿠폰 승인 권한이 있는 승인자가 요청을 승인하면 쿠폰 코드가 생성됩니다.
Note
정식 오픈 전에 앱에서 쿠폰 코드를 입력하고 아이템을 받는 흐름을 확인하려면, 대량 쿠폰을 발행할 때 테스트 쿠폰 수량을 지정해 테스트 쿠폰을 함께 발행하세요. 테스트 쿠폰은 사용 시작일 전에도 사용할 수 있습니다.
2. 쿠폰 사용 요청
사용자가 앱 내 쿠폰 교환소에 쿠폰 코드를 입력하면 앱 클라이언트는 RedeemCouponAsync()를 호출해 쿠폰을 사용 처리합니다. 앱 내 쿠폰 교환소는 사용자가 쿠폰 코드를 입력하는 앱 화면으로, 앱이 직접 만듭니다. 쿠폰 코드를 사용할 수 없으면 RedeemCouponAsync()가 사유별 결과 케이스를 반환하므로, 결과 케이스마다 사용자에게 보여 줄 안내 문구는 앱이 정합니다. 자세한 방법은 쿠폰 사용을 참조하세요.
쿠폰 사용에 성공했다는 것은 지급 우편의 발송 요청이 접수되었다는 뜻이며, 사용자가 아이템을 받았다는 뜻은 아닙니다. 사용자는 3단계와 4단계를 거쳐 아이템을 받습니다.
3. 우편함에 지급 우편 표시
지급 우편은 쿠폰 사용에 성공했을 때 Hive Axyl 서버가 사용자의 앱 내 우편함으로 보내는 우편입니다. 쿠폰에 설정한 아이템은 이 우편에 첨부 아이템으로 담깁니다. 앱 내 우편함은 사용자가 수신 우편을 확인하고 첨부 아이템을 받는 앱 화면으로, 앱이 우편함 모듈을 사용해 직접 만듭니다. 앱 클라이언트는 이 화면에서 수신 우편 목록을 조회해 지급 우편을 사용자에게 보여 줍니다.
우편함 기능 중 앱이 직접 구현해야 하는 작업은 우편함을, 수신 우편 목록 조회는 수신 우편 정보 조회를 참조하세요. 지급 우편의 발신자, 언어, 카테고리는 지급 우편의 발송 정보를 참조하세요.
4. 아이템 지급과 수령 상태 갱신
사용자가 지급 우편의 아이템 받기를 선택하면 앱 서버가 첨부 아이템을 확인하고 사용자에게 아이템을 지급합니다. Hive Axyl SDK의 우편함은 첨부 아이템의 수령 상태만 기록하므로, 앱 서버가 아이템을 지급한 뒤 앱 클라이언트가 우편 읽음 처리로 수령 상태를 갱신합니다.
우편을 열어 보는 화면과 아이템을 받는 동작을 어떻게 나눌지는 앱이 정합니다. 읽음 처리는 우편 읽음 처리를, 지급 우편을 찾아 처리하는 순서는 우편함에서 아이템 수령을 참조하세요.
5. 쿠폰 사용 기록 확인
어떤 쿠폰 코드를 누가 언제 사용했는지는 Hive 콘솔에서 확인합니다. 운영자는 쿠폰 코드 사용 이력에서 쿠폰 코드나 Player ID로 쿠폰 사용 기록을 조회합니다.