프로모션 사용하기¶

프로모션은 게임을 이용하는 유저에게 게임의 새로운 소식이나 이벤트를 효과적으로 노출하는 기능을 제공합니다.
또한 이용 중인 게임에 더 많은 참여를 유도하는 목적으로 활용하거나 다른 게임을 광고하고 보상을 제공하는 크로스 프로모션으로 활용할 수도 있습니다.

프로모션의 기능¶

프로모션은 다음과 같은 기능을 제공합니다.

• 프로모션 컨텐츠를 띄울 수 있는 웹뷰 (프로모션 뷰)
• 원하는 내용으로 구성할 수 있는 커스텀 뷰/커스텀 보드
• 게임 리뷰 팝업, 게임 종료 팝업
• 크로스 프로모션을 위한 오퍼월
• 유저 참여를 유도하는 유저 인게이지먼트(UE, 딥링크)
• 게임 앱 설치를 유도하는 유저 애퀴지션(UA)

프로모션 적용을 위한 선행작업¶

프로모션 적용에 앞서 다음 작업이 선행되어야 합니다.

• 콘솔 프로모션 가이드를 참고하여 Hive 콘솔에 먼저 프로모션 내용을 설정하세요.
  새소식 페이지, 캠페인 페이지, 공지사항, 배너, 오퍼월은 모두 Hive 콘솔에 설정된 정보를 받아서 게임 클라이언트에 띄워 주는 구조를 갖습니다. 즉, 프로모션 내용을 게임에 띄우기 위해서는 Hive 콘솔에 먼저 프로모션 내용이 설정 되어야 합니다.
• Hive 아이템 연동 가이드를 확인하고 Hive 아이템에 연동하세요.
  프로모션을 적용하고 재화를 지급하기 위해서는 Hive 아이템 연동이 필수입니다. 게임 서버는 Hive 아이템에 연동하세요.

프로모션 뷰 결과 통지¶

Promotion API를 이용하여 다음의 프로모션 뷰를 띄우면, Hive는 API 수행 결과를 API 파라미터로 제공 되었던 콜백 핸들러를 통해 반환합니다.

• 전면 배너
• 새소식 페이지
• 커스텀 뷰/커스텀 보드
• 오퍼월
• 게임 리뷰 팝업 - 게임
• 게임 종료 팝업
• 동영상 광고 도입

위 목록에 명시된 프로모션 뷰를 사용하려면 Hive API에서 제공하는 콜백 함수는 다음과 같은 인터페이스 형태를 따라야 합니다.

• Unity®: Promotion 클래스의 onPromotionView() 메서드
• C++: Promotion 클래스의 onPromotionView() 메서드
• Android: PromotionViewListener 클래스의 onPromotionVeiw() 메서드
• iOS: HIVEPromotionViewHandler() 인터페이스

프로모션 뷰 상태¶

프로모션 API를 통해 프로모션 뷰를 띄우면 콜백 함수의 두 번째 파라미터를 통해 PromotionEventType이라는 열거형 데이터를 전달 받습니다. 이 파라미터 값을 통해 프로모션 뷰의 상태를 알 수 있습니다.

다음은 PromotionEventType으로 정의될 수 있는 값들입니다.