콘텐츠로 이동

쿠폰

'쿠폰'은 사용자가 앱에 입력한 쿠폰 코드를 Hive Axyl 서버에서 검증하고, 쿠폰에 설정한 아이템을 우편에 담아 해당 사용자의 앱 내 우편함으로 보내는 기능입니다. 이벤트 보상처럼 운영자가 정한 아이템을 쿠폰 코드로 지급할 때 '쿠폰'을 사용합니다.

운영자가 Hive 콘솔에서 쿠폰을 발행하고 승인하면 쿠폰 코드가 생성됩니다. 사용자는 전달받은 쿠폰 코드를 앱 내 쿠폰 교환소에 입력합니다. 앱 내 쿠폰 교환소는 쿠폰 코드를 입력하는 앱 화면으로, 앱이 직접 구현합니다.

운영자의 쿠폰 발행부터 지급 우편 발송까지의 과정을 나타낸 그림입니다. 운영자가 Hive 콘솔에서 쿠폰을 발행하고 승인하면 쿠폰 코드가 생성됩니다. 사용자가 이 쿠폰 코드를 앱 내 쿠폰 교환소에 입력하면, Hive Axyl 서버는 쿠폰 코드를 검증한 뒤 쿠폰에 설정한 아이템을 담은 지급 우편을 사용자의 앱 내 우편함으로 발송합니다.

Hive Axyl의 역할과 앱의 역할

  • Hive Axyl이 제공하는 기능


    Hive Axyl은 '쿠폰'을 구현할 때 아래 기능을 제공합니다.

    • Hive 콘솔의 쿠폰 발행과 승인, 쿠폰 사용 On/Off 관리
    • 쿠폰 코드 검증과 사용 처리
    • 쿠폰에 설정한 아이템을 담은 지급 우편 발송
    • Hive 콘솔의 쿠폰 코드 사용 이력 조회
  • 앱이 직접 구현해야 하는 작업


    Hive Axyl과 별개로 앱이 직접 구현해야 하는 대표적인 작업은 아래와 같습니다.

    • 앱 내 쿠폰 교환소 UI 구현
    • 쿠폰 사용 결과별 안내 문구 작성과 표시
    • 지급 우편을 우편함 UI에 표시
    • 우편에 첨부된 아이템의 실제 지급과 수령 검증

사전 준비

'쿠폰' 기능을 제공하려면 사용자 로그인이 필요하며, 앱에 우편함 기능도 구현해야 합니다. 쿠폰과 우편함을 함께 구현하는 순서는 쿠폰 지급 구현 순서를 참조하세요.

쿠폰 코드는 운영자가 Hive 콘솔에서 준비합니다. 운영자는 아이템 등록에서 쿠폰으로 지급할 아이템을 먼저 등록한 뒤 쿠폰 발행에서 쿠폰을 발행합니다.

제공 기능

Hive Axyl SDK는 사용자가 입력한 쿠폰 코드를 사용 처리하는 쿠폰 사용 기능을 제공합니다.

쿠폰 사용

쿠폰 사용은 사용자가 입력한 쿠폰 코드를 앱 클라이언트가 Hive Axyl 서버로 보내 사용 처리하는 기능입니다. 사용에 성공하면 Hive Axyl 서버가 쿠폰에 설정한 아이템을 담은 지급 우편을 로그인한 사용자의 앱 내 우편함으로 발송합니다.

쿠폰 코드를 사용할 수 없으면 이미 사용한 쿠폰, 사용 기간이 끝난 쿠폰 등 사유별로 구분한 결과를 반환합니다. 앱은 사유에 맞는 안내 문구를 직접 정해 사용자에게 표시해야 합니다.

더 알아보기

  • 쿠폰 지급 구현 순서: 쿠폰으로 지급할 아이템이 사용자 우편함으로 전달되고 사용자가 이 아이템을 수령하는 과정 전체

다음 단계

Hive Axyl SDK 쿠폰 모듈을 설치합니다.