HIVE 프로모션은 게임을 이용하는 유저에게 게임의 새로운 소식이나 이벤트를 효과적으로 노출하는 기능을 제공한다
프로모션 뷰 (공지, 이벤트), 보상 (쿠폰, 딥링크), 종료 팝업 (안드로이드), 무료 충전소, 리뷰 유도 팝업

더 자세히 ...

클래스
class	Promotion
	HIVE 프로모션은 게임을 이용하는 유저에게 게임의 새로운 소식이나 이벤트를 효과적으로 노출하는 기능을 제공한다 프로모션 뷰 (공지, 이벤트), 보상 (쿠폰, 딥링크), 종료 팝업 (안드로이드), 무료 충전소, 리뷰 유도 팝업 더 자세히 ...

class	PromotionViewInfo
	Promotion 컨텐츠 화면 내용 (HIVE 프로모션 웹 뷰의 UI 를 게임 UI 의 컨셉에 맞추기 위해서 프로모션 웹 뷰를 게임에서 직접 표시하기 위한 정보) 더 자세히 ...

class	PromotionBadgeInfo
	유저에게 새로운 프로모션 내용이 등록 되었음을 알려주기 위한 정보 더 자세히 ...

class	PromotionBannerInfo
	특정 프로모션에 대한 배너 정보 더 자세히 ...

class	AppInvitationData
	‍** 더 자세히 ...

class	AppInvitationCampaign
	앱 초대를 위한 캠패인 정보 캠페인은 초대에 대한 보상을 달상하기 위한 조건을 명시한 데이터. 더 자세히 ...

class	AppInvitationSenderInfo
	UA를 통해 자신을 앱으로 최초 초대한 유저의 정보 더 자세히 ...

타입정의
typedef std::function< void(ResultAPI const &result, PromotionEventType promotionEventType)>	Promotion::onPromotionView
	프로모션 뷰 API 결과 통지 더 자세히 ...

typedef std::function< void(ResultAPI const &result, std::vector< PromotionViewInfo > const &promotionViewInfo)>	Promotion::onPromotionViewInfo
	HIVE 프로모션 웹 뷰의 UI 를 게임 UI 의 컨셉에 맞추기 위해서 프로모션 웹 뷰를 게임에서 직접 구현하기 위한 데이터 반환 더 자세히 ...

typedef std::function< void(ResultAPI const &result, std::vector< PromotionBadgeInfo > const &badgeInfoList)>	Promotion::onPromotionBadgeInfo
	HIVE 프로모션 뱃지 정보 반환 더 자세히 ...

typedef std::function< void(ResultAPI const &result, std::vector< PromotionBannerInfo > const &bannerInfoList)>	Promotion::onPromotionBannerInfo
	프로모션 배너 정보 API 호출에 대한 결과 통지 더 자세히 ...

typedef std::function< void(ResultAPI const &result, AppInvitationData const &appInvitationData)>	Promotion::onAppInvitationData
	앱 초대 (UserAcquisition) 정보 요청에 대한 정보 반환 더 자세히 ...

typedef std::function< void(ResultAPI const &result, EngagementEventType engagementEventType, EngagementEventState engagementEventState, picojson::value const &param)>	Promotion::onEngagement
	SDK 가 특정한 조건에서 클라이언트에 개입 (Engagement) 하기 위한 이벤트 리스너. 더 자세히 ...

열거형 타입
enum class	PromotionType { PromotionType::BANNERLegacy = -1 , PromotionType::BANNER , PromotionType::NEWS , PromotionType::NOTICE }
	프로모션 뷰 창의 형태 더 자세히 ...

enum class	PromotionCustomType { PromotionCustomType::VIEW , PromotionCustomType::BOARD , PromotionCustomType::SPOT , PromotionCustomType::DIRECT }
	커스텀 컨텐츠의 형태 더 자세히 ...

enum class	PromotionEventType { PromotionEventType::OPEN , PromotionEventType::CLOSE , PromotionEventType::START_PLAYBACK , PromotionEventType::FINISH_PLAYBACK , PromotionEventType::EXIT , GOBACK }
	프로모션 뷰 결과 통지시 이벤트 형태 더 자세히 ...

enum class	PromotionBadgeTarget
	프로모션 뱃지 정보가 표시될 대상 정보 만약 NOTICE 이면 공지사항 관련 뱃지를 표시해야한다 더 자세히 ...

enum class	OfferwallState { OfferwallState::ENABLED , OfferwallState::DISABLED , OfferwallState::UNKNOWN }
	게임내 오퍼월(무료 충전소) 을 호출 할 수 있는 버튼 노출 가능 상태 정보 더 자세히 ...

enum class	EngagementEventType { EngagementEventType::EVENT_TYPE , EngagementEventType::PROMOTION_VIEW , OFFERWALL_VIEW , USER_ACQUISITION , EngagementEventType::COUPON , EngagementEventType::AUTH_LOGIN_VIEW , SOCIAL_INQUIRY_VIEW , EngagementEventType::EVENT , EngagementEventType::IAP_UPDATED , EngagementEventType::IAP_PURCHASE , EngagementEventType::IAP_PROMOTE , EngagementEventType::COMPANION , EngagementEventType::SOCIAL_MYINQUIRY_VIEW , EngagementEventType::SOCIAL_PROFILE_VIEW , EngagementEventType::COMMUNITY_VIEW }
	UserEngagement 기능 타입 더 자세히 ...

enum class	EngagementEventState { EngagementEventState::BEGIN , EngagementEventState::FINISH , EngagementEventState::EVENT_START , EngagementEventState::EVENT_END }
	HIVE SDK 가 특정한 조건에서 클라이언트에 개입 (Engagement) 하는 상태 더 자세히 ...

enum class	PromotionCampaignType
	롤링 배너 데이터 요청시 선택한 캠페인 타입 더 자세히 ...

enum class	PromotionBannerType
	롤링 배너 데이터 요청시 선택한 배너 타입 더 자세히 ...

함수
static void	Promotion::showPromotion (PromotionType promotionType, bool isForced, onPromotionView listener)
	게임의 새로운 이벤트나 새로운 게임 소개등의 배너 화면을 노출 더 자세히 ...

static void	Promotion::showCustomContents (PromotionCustomType customType, std::string contentsKey, onPromotionView listener)
	외부 컨텐츠를 사용하기 위해서 커스텀 웹 뷰 노출 더 자세히 ...

static void	Promotion::showCustomContentsOnGameWindow (PromotionCustomType customType, std::string contentsKey, onPromotionView listener)
	외부 컨텐츠를 사용하기 위해서 커스텀 웹 뷰 노출 (GameWindow) 더 자세히 ...

static OfferwallState	Promotion::getOfferwallState ()
	게임내에서 무료 충전소를 노출하기 위한 버튼 UI 는 보여지거나 숨길 수 있도록 구성해야 한다. 더 자세히 ...

static void	Promotion::showOfferwall (onPromotionView listener)
	무료 충전소 화면 노출 (Android only.) 무료 충전소는 HIVE 게임 간의 광고 네트워크로 기존 HIVE 유저들이 새로운 HIVE 게임을 이용할 수 있도록 유도하는 기능이다. 더 자세히 ...

static void	Promotion::showNews (std::string menu, std::vector< int > giftPidList, onPromotionView listener)
	게임의 새로운 이벤트나 새로운 게임 소개등의 새소식 화면을 노출 더 자세히 ...

static void	Promotion::showNativeReview (onPromotionView listener)
	리뷰 유도 팝업 노출 게임 유저들의 긍정적인 평점 및 사용 후기는 다른 유저들이 게임을 이용하는데 영향을 미치게 된다. 더 자세히 ...

static void	Promotion::showReview (onPromotionView listener)
	리뷰 유도 팝업 노출 게임 유저들의 긍정적인 평점 및 사용 후기는 다른 유저들이 게임을 이용하는데 영향을 미치게 된다. 더 자세히 ...

static void	Promotion::showExit (onPromotionView listener)
	종료 확인 팝업 노출 (Android only.) 이용 중인 게임을 종료 하려는 유저에게 새로운 HIVE 게임의 다운로드를 유도하기 위해 '더 많은 게임'이란 버튼을 노출한다 더 자세히 ...

static void	Promotion::getViewInfo (PromotionCustomType customType, std::string contentsKey, onPromotionViewInfo listener)
	HIVE 프로모션 웹 뷰의 UI 를 게임 UI 의 컨셉에 맞추기 위해서 프로모션 웹 뷰를 게임에서 직접 구현 할 수 있다 이 메서드는 게임에서 HIVE 프로모션 웹 뷰를 커스터 마이징하기 위한 정보를 반환한다. 더 자세히 ...

static void	Promotion::getBadgeInfo (onPromotionBadgeInfo listener)
	뱃지 정보 조회 프로모션 뱃지는 유저에게 새로운 프로모션 내용이 등록 되었음을 알려주기 위해서 게임의 버튼 UI 를 부각하는 정보이다 더 자세히 ...

static void	Promotion::getBannerInfo (PromotionCampaignType campaignType, PromotionBannerType bannerType, onPromotionBannerInfo listener)
	배너 정보 조회 특정 프로모션에 대한 배너 정보를 요청한다. 더 자세히 ...

static void	Promotion::getBannerInfoString (std::string campaignString, std::string bannerString, onPromotionBannerInfo listener)
	배너 정보 조회 특정 프로모션에 대한 배너 정보를 요청한다. 더 자세히 ...

static void	Promotion::getAppInvitationData (onAppInvitationData listener)
	앱 초대를 위한 데이터 조회 게임에서 더 많은 사용자를 유치하기 위해서 앱 설치 유도 기능을 제공한다. 더 자세히 ...

static void	Promotion::setAdditionalInfo (std::string additionalInfo)
	프로모션 뷰의 특정 이벤트 페이지를 노출하거나 프로모션 서버에 부가 정보를 전달하고 싶을 때 JSON 포맷의 문자열을 설정할 수 있다 더 자세히 ...

static ResultAPI	Promotion::setEngagementReady (bool isReady)
	Engagement 이벤트 처리가 가능한지(게임 서버에 DB가 생성된 경우 등) 여부를 설정한다. 더 자세히 ...

static bool	Promotion::processURI (std::string URI)
	URI를 파싱하여 Event 타입으로 만든다. 더 자세히 ...

static void	Promotion::setEngagementHandler (onEngagement engagementHandler)
	Engagement 리스너를 등록한다. 더 자세히 ...

static void	Promotion::showUAShare (std::string inviteMessage, std::string inviteLink, onPromotionUAShare uaShareHandler)
	외부 SNS를 통해 UA url을 공유하기 위한 다이얼로그 노출 더 자세히 ...

static void	Promotion::getAppInvitationSenderInfo (onAppInvitationSenderInfo appInvitationSenderInfoHandler)
	UA를 통해 자신을 앱으로 최초 초대한 유저의 정보 반환 한다. 더 자세히 ...

상세한 설명

HIVE 프로모션은 게임을 이용하는 유저에게 게임의 새로운 소식이나 이벤트를 효과적으로 노출하는 기능을 제공한다
프로모션 뷰 (공지, 이벤트), 보상 (쿠폰, 딥링크), 종료 팝업 (안드로이드), 무료 충전소, 리뷰 유도 팝업

타입정의 문서화

◆ onAppInvitationData

typedef std::function<void(ResultAPI const & result, AppInvitationData const & appInvitationData)> Promotion::onAppInvitationData

앱 초대 (UserAcquisition) 정보 요청에 대한 정보 반환

매개변수

result	API 호출 결과
appInvitationData	앱 초대 정보

◆ onEngagement

typedef std::function<void(ResultAPI const & result, EngagementEventType engagementEventType, EngagementEventState engagementEventState, picojson::value const & param)> Promotion::onEngagement

SDK 가 특정한 조건에서 클라이언트에 개입 (Engagement) 하기 위한 이벤트 리스너.

여기서 특정한 조건은 모바일 메시지 (SMS), 푸시 알림 (Push Notification) 으로 전송된 메시지의 URL 클릭이나 프로모션 뷰에서 사용자 동작 등이 있다.

매개변수

result	API 호출 결과
engagementEventType	이벤트 타입
engagementEventState	이벤트 상태
param	이벤트 정보

◆ onPromotionBadgeInfo

typedef std::function<void(ResultAPI const & result, std::vector<PromotionBadgeInfo> const & badgeInfoList)> Promotion::onPromotionBadgeInfo

HIVE 프로모션 뱃지 정보 반환

매개변수

result	API 호출 결과
badgeInfoList	프로모션 뱃지 정보

◆ onPromotionBannerInfo

typedef std::function<void(ResultAPI const & result, std::vector<PromotionBannerInfo> const & bannerInfoList)> Promotion::onPromotionBannerInfo

프로모션 배너 정보 API 호출에 대한 결과 통지

매개변수

result	API 호출 결과
bannerInfoList	프로모션 배너 정보

◆ onPromotionView

typedef std::function<void(ResultAPI const & result, PromotionEventType promotionEventType)> Promotion::onPromotionView

프로모션 뷰 API 결과 통지

매개변수

result	API 호출 결과
promotionEventType	프로모션 창 이벤트 형태

◆ onPromotionViewInfo

typedef std::function<void(ResultAPI const & result, std::vector<PromotionViewInfo> const & promotionViewInfo)> Promotion::onPromotionViewInfo

HIVE 프로모션 웹 뷰의 UI 를 게임 UI 의 컨셉에 맞추기 위해서 프로모션 웹 뷰를 게임에서 직접 구현하기 위한 데이터 반환

매개변수

result	API 호출 결과
promotionViewInfo	프로모션 웹 뷰 정보

열거형 타입 문서화

◆ EngagementEventState

enum class EngagementEventState

strong

HIVE SDK 가 특정한 조건에서 클라이언트에 개입 (Engagement) 하는 상태

열거형 멤버
BEGIN	Engagement에 의해 최초 기능이 수행되기 시작함을 알림.
FINISH	Engagement에 의한 모든 기능 수행이 종료됨을 알림.
EVENT_START	Engagement에 의해 특정 기능이 수행되기 시작함을 알림.
EVENT_END	Engagement에 의한 특정 기능 수행이 종료됨을 알림.

◆ EngagementEventType

enum class EngagementEventType

strong

UserEngagement 기능 타입

열거형 멤버
EVENT_TYPE	< kHIVEEngagementEventType Engagement의 전체 시작과 끝을 알리는 경우. (이름 변경 예정)
PROMOTION_VIEW	kHIVEEngagementEventTypePromotionView Engagement에 의해 처리되는 PromotionView인 경우. EventState가 kHIVEEngagementStateEventEnd인 경우 PromotionView의 결과가 ResultAPI와 Param으로 전달된다.
COUPON	kHIVEEngagementEventTypeCoupon Engagement에 의해 처리된 쿠폰 소모에 대한 결과. EventState가 kHIVEEngagementStateEventEnd인 경우 쿠폰사용의 결과가 ResultAPI와 Param으로 전달된다.
AUTH_LOGIN_VIEW	kHIVEEngagementEventTypeAuthLogin 유저(클라이언트)에 의해 열리지 않은 로그인 프로세스에 의한 결과를 받는 콜백.
EVENT	kHIVEEngagementEventTypeEvent Engagement에 의해 처리될 수 없는 이벤트(host가 game인 경우)를 전달해주는 콜백.
IAP_UPDATED	Deprecated in HIVE SDK 4.5.0
IAP_PURCHASE	kHIVEEngagementEventTypeIapPurchase 앱이 시작 혹은 실행 중일 때, 앱 외에서 상품을 구매시도시 불리게 되는 콜백. 해당 콜백이 불리면 구매 팝업이 노출되며 Engagement ready 상태가 false로 변경된다.
IAP_PROMOTE	kHIVEEngagementEventTypeIapPromote 앱이 시작 혹은 실행 중일 때, 앱 외에서 상품을 구매시도시 불리게 되는 콜백. 해당 콜백이 불리면 게임에서는 아이템 구매가 가능한 적정한 시점에 checkPromotePurchase: 를 호출하여야 한다.
COMPANION	Promotion CPA Link recevied. SDK Will be send promotion companion.
SOCIAL_MYINQUIRY_VIEW	내 문의 내역을 오픈
SOCIAL_PROFILE_VIEW	프로필 페이지 오픈
COMMUNITY_VIEW	커뮤니티 페이지를 오픈. Open the community page.

◆ OfferwallState

enum class OfferwallState

strong

게임내 오퍼월(무료 충전소) 을 호출 할 수 있는 버튼 노출 가능 상태 정보

열거형 멤버
ENABLED	게임내 무료 충전 버튼 노출 가능
DISABLED	게임내 무료 충전 버튼 노출 불가능
UNKNOWN	버튼 노출 가능 상태를 알 수 없음

◆ PromotionBadgeTarget

enum class PromotionBadgeTarget

strong

프로모션 뱃지 정보가 표시될 대상 정보
만약 NOTICE 이면 공지사항 관련 뱃지를 표시해야한다

◆ PromotionBannerType

enum class PromotionBannerType

strong

롤링 배너 데이터 요청시 선택한 배너 타입

작성자: Seokjin Yong

◆ PromotionCampaignType

enum class PromotionCampaignType

strong

롤링 배너 데이터 요청시 선택한 캠페인 타입

작성자: Seokjin Yong

◆ PromotionCustomType

enum class PromotionCustomType

strong

커스텀 컨텐츠의 형태

작성자: kjkim

열거형 멤버
VIEW	커스텀 뷰
BOARD	커스텀 보드
SPOT	스팟 배너
DIRECT	다이렉트 캠페인

◆ PromotionEventType

enum class PromotionEventType

strong

프로모션 뷰 결과 통지시 이벤트 형태

작성자: ryuvsken

열거형 멤버
OPEN	프로모션 뷰가 열렸을 때
CLOSE	프로모션 뷰가 닫혔을 때
START_PLAYBACK	영상 재생이 시작되었을 때
FINISH_PLAYBACK	영상 재생이 완료되었을 때
EXIT	종료(더 많은 게임 보기) 팝업에서 종료하기를 선택했을 때

◆ PromotionType

enum class PromotionType

strong

프로모션 뷰 창의 형태

작성자: ryuvsken

열거형 멤버
BANNERLegacy	전면배너 (웹뷰만 사용하는 구 버전)
BANNER	전면배너
NEWS	새소식
NOTICE	공지사항

함수 문서화

◆ getAppInvitationData()

static void Promotion::getAppInvitationData ( onAppInvitationData listener )

static

앱 초대를 위한 데이터 조회
게임에서 더 많은 사용자를 유치하기 위해서 앱 설치 유도 기능을 제공한다.

앱 설치 유도는 유저 애퀴지션 (User Acquisition) 이라고도 부른다.
앱의 초대를 위한 데이터는 QR Code, 초대링크, 캠페인 등이 있다.
캠페인은 초대에 대한 보상을 달상하기 위한 조건을 명시한 데이터이다.
초대 URL 또는 QR코드를 통해 초대받은 유저가 게임을 설치하고, 특정 레벨 달성 등과 같은 조건(백오피스에서 조건 및 보상 설정 가능)을 달성했을 때 초대한 유저와 초대받은 유저 모두에게 보상을 제공한다.

매개변수

listener API 호출 결과.

◆ getAppInvitationSenderInfo()

static void Promotion::getAppInvitationSenderInfo ( onAppInvitationSenderInfo appInvitationSenderInfoHandler )

static

UA를 통해 자신을 앱으로 최초 초대한 유저의 정보 반환 한다.

SDK 초기화, 로그인, setEngagementReady(true) 호출 이후 최초 초대자 정보 전달이 가능하다.

매개변수

AppInvitationSenderInfoHandler API 결과 통지 리스터

◆ getBadgeInfo()

static void Promotion::getBadgeInfo ( onPromotionBadgeInfo listener )

static

뱃지 정보 조회
프로모션 뱃지는 유저에게 새로운 프로모션 내용이 등록 되었음을 알려주기 위해서 게임의 버튼 UI 를 부각하는 정보이다

매개변수

listener API 결과 통지

◆ getBannerInfo()

static void Promotion::getBannerInfo	(	PromotionCampaignType	campaignType,
		PromotionBannerType	bannerType,
		onPromotionBannerInfo	listener
	)

static

배너 정보 조회
특정 프로모션에 대한 배너 정보를 요청한다.

게임 서버에서 배너 정보를 조회하기 위해 사용된다.

매개변수

campaignType	"event", "notice", "all", "cross"
handler	API 결과 통지

◆ getBannerInfoString()

static void Promotion::getBannerInfoString	(	std::string	campaignString,
		std::string	bannerString,
		onPromotionBannerInfo	listener
	)

static

배너 정보 조회
특정 프로모션에 대한 배너 정보를 요청한다.

게임 서버에서 배너 정보를 조회하기 위해 사용된다.

매개변수

campaignType	커스텀 String campaign type
handler	API 결과 통지

◆ getOfferwallState()

static OfferwallState Promotion::getOfferwallState ( )

static

게임내에서 무료 충전소를 노출하기 위한 버튼 UI 는 보여지거나 숨길 수 있도록 구성해야 한다.

이 메서드는 게임내에서 오퍼월(무료 충전소) 을 호출 할 수 있는 버튼 노출 가능 여부를 반환한다.

반환값: 오퍼월(무료 충전소) 을 호출 할 수 있는 버튼 노출 가능 여부

◆ getViewInfo()

static void Promotion::getViewInfo	(	PromotionCustomType	customType,
		std::string	contentsKey,
		onPromotionViewInfo	listener
	)

static

HIVE 프로모션 웹 뷰의 UI 를 게임 UI 의 컨셉에 맞추기 위해서 프로모션 웹 뷰를 게임에서 직접 구현 할 수 있다
이 메서드는 게임에서 HIVE 프로모션 웹 뷰를 커스터 마이징하기 위한 정보를 반환한다.

매개변수

listener API 결과 통지

◆ processURI()

static bool Promotion::processURI ( std::string URI )

static

URI를 파싱하여 Event 타입으로 만든다.

매개변수

URI 파싱할 URI

반환값: 파싱에 문제가 없으면 true, 아니면 false.

◆ setAdditionalInfo()

static void Promotion::setAdditionalInfo ( std::string additionalInfo )

static

프로모션 뷰의 특정 이벤트 페이지를 노출하거나 프로모션 서버에 부가 정보를 전달하고 싶을 때 JSON 포맷의 문자열을 설정할 수 있다

(필수)서버군이 따로 없는 단일 서버군이라도 아래 예제대로 넣어야 함
ex)"addtionalInfo":"{"server":"0","character":"0"}"

매개변수

additionalInfo (필수) JSON 포맷의 부가 정보 데이터

◆ setEngagementHandler()

static void Promotion::setEngagementHandler ( onEngagement engagementHandler )

static

Engagement 리스너를 등록한다.

매개변수

engagementHandler

◆ setEngagementReady()

static ResultAPI Promotion::setEngagementReady ( bool isReady )

static

Engagement 이벤트 처리가 가능한지(게임 서버에 DB가 생성된 경우 등) 여부를 설정한다.

true로 설정하려는 경우, <로그인 이후 & 리스너가 등록된 이후>의 조건을 만족한 상태여야 정상적으로 설정되며, false로 설정하려는 경우는 항상 설정 가능하다.

매개변수

isReady Enganement 이벤트 처리 가능 여부.

반환값: API 호출 성공 여부.

◆ showCustomContents()

static void Promotion::showCustomContents	(	PromotionCustomType	customType,
		std::string	contentsKey,
		onPromotionView	listener
	)

static

외부 컨텐츠를 사용하기 위해서 커스텀 웹 뷰 노출

매개변수

promotionCustomType	PromotionCustomType Type
contentsKey	백오피스에 설정된 사용자 정의 페이지의 id
listener	API 결과 통지 리스너

◆ showCustomContentsOnGameWindow()

static void Promotion::showCustomContentsOnGameWindow	(	PromotionCustomType	customType,
		std::string	contentsKey,
		onPromotionView	listener
	)

static

외부 컨텐츠를 사용하기 위해서 커스텀 웹 뷰 노출 (GameWindow)

매개변수

promotionCustomType	PromotionCustomType Type
contentsKey	백오피스에 설정된 사용자 정의 페이지의 id
listener	API 결과 통지 리스너

◆ showExit()

static void Promotion::showExit ( onPromotionView listener )

static

종료 확인 팝업 노출 (Android only.)
이용 중인 게임을 종료 하려는 유저에게 새로운 HIVE 게임의 다운로드를 유도하기 위해 '더 많은 게임'이란 버튼을 노출한다

매개변수

listener API 결과 통지

◆ showNativeReview()

static void Promotion::showNativeReview ( onPromotionView listener )

static

리뷰 유도 팝업 노출
게임 유저들의 긍정적인 평점 및 사용 후기는 다른 유저들이 게임을 이용하는데 영향을 미치게 된다.

리뷰 유도 팝업을 제공하면 유저의 참여 건수가 5~10배 증가하는 것으로 알려져 있다.
iOS 10.3 이상의 기기에서는 앱 내부에서 평점 및 리뷰를 작성할 수 있는 팝업이 노출된다.

Since: 4.10.0

◆ showNews()

static void Promotion::showNews	(	std::string	menu,
		std::vector< int >	giftPidList,
		onPromotionView	listener
	)

static

게임의 새로운 이벤트나 새로운 게임 소개등의 새소식 화면을 노출

매개변수

menu	최초 노출시 활성화할 메뉴 관리 명
handler	API 결과 통지

◆ showOfferwall()

static void Promotion::showOfferwall ( onPromotionView listener )

static

무료 충전소 화면 노출 (Android only.)
무료 충전소는 HIVE 게임 간의 광고 네트워크로 기존 HIVE 유저들이 새로운 HIVE 게임을 이용할 수 있도록 유도하는 기능이다.

유저가 다운로드 받을 수 있는 게임을 목록으로 노출하고 게임을 다운로드 받아 실행하면 매체가 되는 게임에서 보상이 제공된다.

매개변수

listener API 결과 통지

◆ showPromotion()

static void Promotion::showPromotion	(	PromotionType	promotionType,
		bool	isForced,
		onPromotionView	listener
	)

static

게임의 새로운 이벤트나 새로운 게임 소개등의 배너 화면을 노출

매개변수

promotionType 프로모션 뷰 창의 형태

isForced

type이 "notice" 와 "event" 일 때만 동작

                        true일 경우 24시간 다시보지 않기를 무시한다.
                        (주의:24시간 다시보기가 적용되지 않으므로 버튼 액션으로 보는 등 특정 액션에서만 사용해야 함.)

                        false이거나 생략할 경우 24시간 안보기가 정상동작함.

listener API 결과 통지

◆ showReview()

static void Promotion::showReview ( onPromotionView listener )

static

리뷰 유도 팝업 노출
게임 유저들의 긍정적인 평점 및 사용 후기는 다른 유저들이 게임을 이용하는데 영향을 미치게 된다.

리뷰 유도 팝업을 제공하면 유저의 참여 건수가 5~10배 증가하는 것으로 알려져 있다.
Hive 콘솔 설정에 따라 Hive 일반 리뷰 팝업과 이미지 수정이 가능한 커스텀 리뷰 팝업이 노출된다.

◆ showUAShare()

static void Promotion::showUAShare	(	std::string	inviteMessage,
		std::string	inviteLink,
		onPromotionUAShare	uaShareHandler
	)

static

외부 SNS를 통해 UA url을 공유하기 위한 다이얼로그 노출

매개변수

inviteMessage	UA 초대 메시지
inviteLink	UA 초대 링크
uaShareHandler	API 결과 통지 리스너

HIVE SDK for C++

클래스

타입정의

열거형 타입

함수

상세한 설명

타입정의 문서화

◆ onAppInvitationData

◆ onEngagement

◆ onPromotionBadgeInfo

◆ onPromotionBannerInfo

◆ onPromotionView

◆ onPromotionViewInfo

열거형 타입 문서화

◆ EngagementEventState

◆ EngagementEventType

◆ OfferwallState

◆ PromotionBadgeTarget

◆ PromotionBannerType

◆ PromotionCampaignType

◆ PromotionCustomType

◆ PromotionEventType

◆ PromotionType

함수 문서화

◆ getAppInvitationData()

◆ getAppInvitationSenderInfo()

◆ getBadgeInfo()

◆ getBannerInfo()

◆ getBannerInfoString()

◆ getOfferwallState()

◆ getViewInfo()

◆ processURI()

◆ setAdditionalInfo()

◆ setEngagementHandler()

◆ setEngagementReady()

◆ showCustomContents()

◆ showCustomContentsOnGameWindow()

◆ showExit()

◆ showNativeReview()

◆ showNews()

◆ showOfferwall()

◆ showPromotion()

◆ showReview()

◆ showUAShare()