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

더 자세히 ...

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

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

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

class	HIVEAppInvitationData
	앱 초대(UserAcquisition)를 위한 정보. 더 자세히 ...

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

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

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

타입정의
typedef void(^	HIVEPromotionViewHandler) (HIVEResultAPI *result, HIVEPromotionViewResultType type)
	프로모션 뷰 API 결과 통지 더 자세히 ...

typedef void(^	HIVEPromotionInfoHandler) (HIVEResultAPI result, NSArray< HIVEPromotionViewInfo > *viewInfos)
	HIVE 프로모션 웹 뷰의 UI 를 게임 UI 의 컨셉에 맞추기 위해서 프로모션 웹 뷰를 게임에서 직접 구현하기 위한 데이터 반환 더 자세히 ...

typedef void(^	HIVEPromotionBadgeHandler) (HIVEResultAPI result, NSArray< HIVEPromotionBadge > *badgeInfos)
	HIVE 프로모션 뱃지 정보 반환 더 자세히 ...

typedef void(^	HIVEPromotionBannerInfoHandler) (HIVEResultAPI result, NSArray< HIVEPromotionBanner > *bannerInfos)
	프로모션 배너 정보 API 호출에 대한 결과 통지 더 자세히 ...

typedef void(^	HIVEPromotionShareHandler) (HIVEResultAPI *result)
	HIVE UA 공유 정보 반환 더 자세히 ...

typedef void(^	HIVEAppInvitationDataHandler) (HIVEResultAPI result, HIVEAppInvitationData invitationData)
	앱 초대(UserAcquisition) 정보 요청에 대한 정보 반환 더 자세히 ...

typedef void(^	HIVEEngagementHandler) (HIVEResultAPI result, HIVEEngagementEventType engagementEventType, HIVEEngagementEventState engagementState, NSDictionary param)
	SDK 가 특정한 조건에서 클라이언트에 개입(Engagement)하기 위한 이벤트 리스너. 더 자세히 ...

열거형 타입
enum	HIVEPromotionViewResultType { kHIVEPromotionViewResultTypeOpen = 0, kHIVEPromotionViewResultTypeClose }
	프로모션 뷰 결과 통지시 이벤트 형태 더 자세히 ...

enum	HIVEPromotionViewType { kHIVEPromotionViewTypeBANNERLegacy = -1, kHIVEPromotionViewTypeBANNER = 0, kHIVEPromotionViewTypeNEWS, kHIVEPromotionViewTypeNOTICE }
	프로모션 뷰 창의 형태 더 자세히 ...

enum	HIVEPromotionCustomType { kHIVEPromotionCustomTypeVIEW = 0, kHIVEPromotionCustomTypeBOARD, kHIVEPromotionCustomTypeSPOT, kHIVEPromotionCustomTypeDIRECT }
	커스텀 컨텐츠의 형태 더 자세히 ...

enum	HIVEPromotionBadgeTarget { kHIVEPromotionBadgeTargetNEWS = 0, kHIVEPromotionBadgeTargetNOTICE, kHIVEPromotionBadgeTargetCUSTOMVIEW, kHIVEPromotionBadgeTargetCUSTOMBOARD }
	프로모션 뱃지 정보가 표시될 대상 정보 만약 NOTICE이면 공지사항 관련 뱃지를 표시해야한다 더 자세히 ...

함수
typedef	NS_ENUM (NSUInteger, HIVEOfferwallState)
	게임내 오퍼월(무료 충전소) 을 호출 할 수 있는 버튼 노출 가능 상태 정보 더 자세히 ...

typedef	NS_ENUM (NSInteger, HIVEPromotionCampaignType)
	롤링 배너 데이터 요청시 선택한 캠페인 타입 더 자세히 ...

typedef	NS_ENUM (NSInteger, HIVEPromotionBannerType)
	롤링 배너 데이터 요청시 선택한 배너 타입 더 자세히 ...

typedef	NS_ENUM (NSUInteger, HIVEEngagementEventType)
	UserEngagement 기능 타입 더 자세히 ...

typedef	NS_ENUM (NSUInteger, HIVEEngagementEventState)
	HIVE SDK가 특정한 조건에서 클라이언트에 개입(Engagement)하는 상태 더 자세히 ...

(void)	+ HIVEPromotion::showPromotion:isForced:handler:
	게임의 새로운 이벤트나 새로운 게임 소개등의 배너 화면을 노출 더 자세히 ...

(void)	+ HIVEPromotion::showCustomContents:contents:handler:
	외부 컨텐츠를 사용하기 위해서 커스텀 웹 뷰 노출 더 자세히 ...

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

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

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

(void)	+ HIVEPromotion::getViewInfo:contents:handler:
	HIVE 프로모션 웹 뷰의 UI 를 게임 UI 의 컨셉에 맞추기 위해서 프로모션 웹 뷰를 게임에서 직접 구현 할 수 있다 이 메서드는 게임에서 HIVE 프로모션 웹 뷰를 커스터 마이징하기 위한 정보를 반환한다. 더 자세히 ...

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

(void)	+ HIVEPromotion::getBannerInfo:bannerType:handler:
	배너 정보 조회 특정 프로모션에 대한 배너 정보를 요청한다. 더 자세히 ...

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

(void)	+ HIVEPromotion::showUAShare:inviteLink:handler:
	외부 SNS를 통해 UA url을 공유하기 위한 다이얼로그 노출 더 자세히 ...

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

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

(void)	+ HIVEPromotion::setEngagementHandler:
	Engagement 리스너를 등록한다. 더 자세히 ...

(BOOL)	+ HIVEPromotion::processURI:
	인게이지먼트 이벤트 URI를 HIVE 모듈에 전달한다. 더 자세히 ...

속성
HIVEPromotionBadgeTarget	HIVEPromotionBadge::target
	뱃지를 표시해줘야하는 타겟 예를 들어서 NOTICE이면 공지사항 관련 뱃지를 표시해야 한다. 더 자세히 ...

NSString *	HIVEPromotionBadge::contentsKey
	타겟이 커스텀 컨텐츠일 경우 백오피스에 등록된 프로모션 고유 ID

NSString *	HIVEPromotionBadge::badgeType
	뱃지 종류 ("new" or "none" 이 올 수 있다)

NSString *	HIVEPromotionViewInfo::url
	프로모션 뷰를 로드하기 위한 웹뷰의 정보 더 자세히 ...

NSString *	HIVEPromotionViewInfo::postString
	웹뷰 로드시 필요한 POST 데이터. URLRequest에 이 데이터가 없으면 HIVEPromotion에서 제공하는 페이지를 볼 수 없다.

NSData *	HIVEAppInvitationData::qrcode
	앱의 초대 정보가 포함된 QR Code 이미지 데이터

NSString *	HIVEAppInvitationData::inviteCommonLink
	기본 초대 링크

NSString *	HIVEAppInvitationData::inviteHivemsgLink
	HIVE 인증 사용자용 초대 링크

NSString *	HIVEAppInvitationData::inviteFacebookLink
	Facebook 인증 사용자용 초대 링크

NSString *	HIVEAppInvitationData::inviteMessage
	초대 문구 (HIVE SDK v4.11.4+)

NSArray< HIVEAppInvitationCampaign * > *	HIVEAppInvitationData::eachCampaigns
	캠페인 완료 발생시, 매번 보상을 지급하는 캠페인 목록

NSArray< HIVEAppInvitationCampaignStage * > *	HIVEAppInvitationData::stageCampaigns
	캠페인 완료 목표 초대 수를 달성했을 때 보상을 지급하는 캠페인 목록

NSString *	HIVEAppInvitationData::originalJson
	가공되지 않은 원본 데이터

NSString *	HIVEAppInvitationCampaign::title
	캠페인 타이틀

NSString *	HIVEAppInvitationCampaign::desc
	캠페인 설명

NSString *	HIVEAppInvitationCampaign::imgURL
	캠페인 이미지 URL

NSDictionary *	HIVEAppInvitationCampaign::item
	완료 보상 정보 ("key" 는 캠페인 설정에 따라 상이함)

NSInteger	HIVEAppInvitationCampaign::count
	초대 인원 중. 캠페인을 완료한 수

NSInteger	HIVEAppInvitationCampaign::limit
	캠페인 최대 인원 수

NSInteger	HIVEAppInvitationCampaignStage::goalCount
	모든 단계를 완료한 인원 수

NSInteger	HIVEAppInvitationCampaignStage::goalTotal
	보상을 받기 위해 모든 단계를 완료해야 하는 인원 수

상세한 설명

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

타입정의 문서화

§ HIVEAppInvitationDataHandler

typedef void(^ HIVEAppInvitationDataHandler) (HIVEResultAPI *result, HIVEAppInvitationData *invitationData)

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

매개변수

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

§ HIVEEngagementHandler

typedef void(^ HIVEEngagementHandler) (HIVEResultAPI *result, HIVEEngagementEventType engagementEventType, HIVEEngagementEventState engagementState, NSDictionary *param)

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

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

매개변수

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

§ HIVEPromotionBadgeHandler

typedef void(^ HIVEPromotionBadgeHandler) (HIVEResultAPI *result, NSArray< HIVEPromotionBadge * > *badgeInfos)

HIVE 프로모션 뱃지 정보 반환

매개변수

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

§ HIVEPromotionBannerInfoHandler

typedef void(^ HIVEPromotionBannerInfoHandler) (HIVEResultAPI *result, NSArray< HIVEPromotionBanner * > *bannerInfos)

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

매개변수

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

§ HIVEPromotionInfoHandler

typedef void(^ HIVEPromotionInfoHandler) (HIVEResultAPI *result, NSArray< HIVEPromotionViewInfo * > *viewInfos)

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

매개변수

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

§ HIVEPromotionShareHandler

typedef void(^ HIVEPromotionShareHandler) (HIVEResultAPI *result)

HIVE UA 공유 정보 반환

매개변수

result API 호출 결과

§ HIVEPromotionViewHandler

typedef void(^ HIVEPromotionViewHandler) (HIVEResultAPI *result, HIVEPromotionViewResultType type)

프로모션 뷰 API 결과 통지

매개변수

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

열거형 타입 문서화

§ HIVEPromotionBadgeTarget

enum HIVEPromotionBadgeTarget

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

열거형 멤버
kHIVEPromotionBadgeTargetNEWS	새소식 타겟
kHIVEPromotionBadgeTargetNOTICE	공지사항 타겟
kHIVEPromotionBadgeTargetCUSTOMVIEW	커스텀뷰 타겟
kHIVEPromotionBadgeTargetCUSTOMBOARD	커스텀 보드 타겟

§ HIVEPromotionCustomType

enum HIVEPromotionCustomType

커스텀 컨텐츠의 형태

열거형 멤버
kHIVEPromotionCustomTypeVIEW	커스텀 뷰
kHIVEPromotionCustomTypeBOARD	커스텀 보드
kHIVEPromotionCustomTypeSPOT	스팟 배너
kHIVEPromotionCustomTypeDIRECT	다이렉트 캠페인

§ HIVEPromotionViewResultType

enum HIVEPromotionViewResultType

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

열거형 멤버
kHIVEPromotionViewResultTypeOpen	프로모션 뷰 창이 열렸을 때
kHIVEPromotionViewResultTypeClose	프로모션 뷰 창이 닫혔을 때

§ HIVEPromotionViewType

enum HIVEPromotionViewType

프로모션 뷰 창의 형태

열거형 멤버
kHIVEPromotionViewTypeBANNERLegacy	전면배너 (웹뷰만 사용하는 구 버전)
kHIVEPromotionViewTypeBANNER	전면배너
kHIVEPromotionViewTypeNEWS	새소식
kHIVEPromotionViewTypeNOTICE	공지사항

함수 문서화

§ getAppInvitationData:()

+ (void) getAppInvitationData: (HIVEAppInvitationDataHandler) handler

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

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

매개변수

handler API 호출 결과.

§ getBadgeInfo:()

+ (void) getBadgeInfo: (HIVEPromotionBadgeHandler) handler

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

매개변수

handler API 결과 통지

§ getBannerInfo:bannerType:handler:()

+ (void) getBannerInfo:	(HIVEPromotionCampaignType)	campaignType
bannerType:	(HIVEPromotionBannerType)	bannerType
handler:	(HIVEPromotionBannerInfoHandler)	handler

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

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

매개변수

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

§ getOfferwallState()

+ (HIVEOfferwallState) getOfferwallState

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

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

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

§ getViewInfo:contents:handler:()

+ (void) getViewInfo:	(HIVEPromotionCustomType)	type
contents:	(NSString *)	key
handler:	(HIVEPromotionInfoHandler)	handler

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

매개변수

type	커스텀 컨텐츠의 타입
key	백오피스에 등록된 해당 컨텐츠의 고유 키
handler	API 결과 통지 리스너

§ NS_ENUM() [1/5]

typedef NS_ENUM	(	NSUInteger	,
		HIVEOfferwallState
	)

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

작성자: KyuJin Kim

< 게임내 무료 충전 버튼 노출 가능

< 게임내 무료 충전 버튼 노출 불가능

< 상태를 알 수 없음

§ NS_ENUM() [2/5]

typedef NS_ENUM	(	NSInteger	,
		HIVEPromotionCampaignType
	)

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

작성자: Seokjin Yong

§ NS_ENUM() [3/5]

typedef NS_ENUM	(	NSInteger	,
		HIVEPromotionBannerType
	)

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

작성자: Seokjin Yong

§ NS_ENUM() [4/5]

typedef NS_ENUM	(	NSUInteger	,
		HIVEEngagementEventType
	)

UserEngagement 기능 타입

< Engagement의 전체 시작과 끝을 알리는 경우.

< Engagement로 처리하는 PromotionView인 경우.

< Engagement로 처리하는 OfferwallView인 경우. EventState가 kHIVEEngagementStateEventEnd인 경우 PromotionView의 결과가 ResultAPI와 Param으로 전달된다.

< 아직 지원하지 않음.

< Engagement로 처리한 쿠폰 소모에 대한 결과.

< 유저(클라이언트)에 의해 열리지 않은 로그인 프로세스 결과를 받는 콜백.

< Social Cafe 오픈.

< 1:1문의를 오픈.

< Social Message를 이용한 Social 유저에게 게임 초대 기능.

< Social Message를 이용한 Social 유저에게 메세지 보내기.

< Engagement로 처리할 수 없는 이벤트(host가 game인 경우)를 전달해주는 콜백.

< 아이템 구매 시도 시 호출하는 콜백.

< 앱이 시작 혹은 실행 중일 때, 앱 외에서 상품을 구매 시도 시 호출하는 콜백. 혹은 Interwork를 통해 아이템 구매 시도 시 아이템 정보를 전달하는 콜백 .

< 크로스 프로모션 캠페인 액션 수행 시 프로모션 CPA 링크 수신. SDK에서 크로스 프로모션 정보 전달을 수행했음.

§ NS_ENUM() [5/5]

typedef NS_ENUM	(	NSUInteger	,
		HIVEEngagementEventState
	)

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

< Engagement의 작동이 시작되었음을 알림.

< Engagement의 작동이 종료되었음을 알림.

< Engagement에 의해 다른 기능이 수행되기 시작함을 알림.

< Engagement에 의한 다른 기능 수행이 종료됨을 알림.

§ processURI:()

+ (BOOL) processURI: (NSURL *) URI

인게이지먼트 이벤트 URI를 HIVE 모듈에 전달한다.

Added in HIVE SDK 4.4.0 Modified in HIVE SDK 4.5.0

매개변수

URI	인게이지먼트 기능 수행할 URI

§ setAdditionalInfo:()

+ (void) setAdditionalInfo: (NSString *) additionalInfo

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

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

매개변수

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

§ setEngagementHandler:()

+ (void) setEngagementHandler: (HIVEEngagementHandler) engagementHandler

Engagement 리스너를 등록한다.

매개변수

engagementHandler HIVEEngagementHandler

§ setEngagementReady:()

+ (HIVEResultAPI *) setEngagementReady: (BOOL) isReady

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

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

매개변수

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

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

§ showCustomContents:contents:handler:()

+ (void) showCustomContents:	(HIVEPromotionCustomType)	type
contents:	(NSString *)	key
handler:	(HIVEPromotionViewHandler)	handler

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

매개변수

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

§ showNativeReview()

+ (void) showNativeReview

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

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

Since: 4.10.0

§ showOfferwall:()

+ (void) showOfferwall: (HIVEPromotionViewHandler) handler

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

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

매개변수

handler API 결과 통지

§ showPromotion:isForced:handler:()

+ (void) showPromotion:	(HIVEPromotionViewType)	type
isForced:	(BOOL)	isForced
handler:	(HIVEPromotionViewHandler)	handler

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

매개변수

type 프로모션 뷰 창의 형태

isForced

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

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

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

handler API 결과 통지

§ showUAShare:inviteLink:handler:()

+ (void) showUAShare:	(NSString *)	inviteMessage
inviteLink:	(NSString *)	inviteLink
handler:	(HIVEPromotionShareHandler)	handler

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

매개변수

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

속성

§ target

- (HIVEPromotionBadgeTarget) target

readnonatomicassign

뱃지를 표시해줘야하는 타겟
예를 들어서 NOTICE이면 공지사항 관련 뱃지를 표시해야 한다.

(NEWS, NOTICE, CUSTOMVIEW, CUSTOMBOARD가 올 수 있다)

§ url

- (NSString*) url

readnonatomicstrong

프로모션 뷰를 로드하기 위한 웹뷰의 정보

웹뷰로 로드할 URL.

HIVE SDK for iOS

클래스

타입정의

열거형 타입

함수

속성

상세한 설명

타입정의 문서화

§ HIVEAppInvitationDataHandler

§ HIVEEngagementHandler

§ HIVEPromotionBadgeHandler

§ HIVEPromotionBannerInfoHandler

§ HIVEPromotionInfoHandler

§ HIVEPromotionShareHandler

§ HIVEPromotionViewHandler

열거형 타입 문서화

§ HIVEPromotionBadgeTarget

§ HIVEPromotionCustomType

§ HIVEPromotionViewResultType

§ HIVEPromotionViewType

함수 문서화

§ getAppInvitationData:()

§ getBadgeInfo:()

§ getBannerInfo:bannerType:handler:()

§ getOfferwallState()

§ getViewInfo:contents:handler:()

§ NS_ENUM() [1/5]

§ NS_ENUM() [2/5]

§ NS_ENUM() [3/5]

§ NS_ENUM() [4/5]

§ NS_ENUM() [5/5]

§ processURI:()

§ setAdditionalInfo:()

§ setEngagementHandler:()

§ setEngagementReady:()

§ showCustomContents:contents:handler:()

§ showNativeReview()

§ showOfferwall:()

§ showPromotion:isForced:handler:()

§ showUAShare:inviteLink:handler:()

속성

§ target

§ url