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

더 자세히 ...

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

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

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

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

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

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

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

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

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

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

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

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

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

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

enum class	EHiveEngagementEventType
	UserEngagement 기능 타입 더 자세히 ...

enum class	EHiveEngagementEventState
	HIVE SDK 가 특정한 조건에서 클라이언트에 개입 (Engagement) 하는 상태 더 자세히 ...

함수
static void	FHivePromotion::ShowPromotion (const EHivePromotionType &PromotionType, bool IsForced, const FHivePromotionViewDelegate &Delegate)
	게임의 새로운 이벤트나 새로운 게임 소개등의 배너 화면을 노출 더 자세히 ...

static void	FHivePromotion::ShowCustomContents (const EHivePromotionCustomType &PromotionCustomType, const FString &ContentsKey, const FHivePromotionViewDelegate &Delegate)
	외부 컨텐츠를 사용하기 위해서 커스텀 웹 뷰 노출 더 자세히 ...

static void	FHivePromotion::ShowCustomContentsOnGameWindow (const EHivePromotionCustomType &PromotionCustomType, const FString &ContentsKey, const FHivePromotionViewDelegate &Delegate)
	외부 컨텐츠를 사용하기 위해서 커스텀 웹 뷰 노출 (GameWindow) 더 자세히 ...

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

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

static void	FHivePromotion::ShowNews (const FString &Menu, const TArray< int32 > &GiftPidList, const FHivePromotionViewDelegate &Delegate)
	게임의 새로운 이벤트나 새로운 게임 소개등의 새소식 화면을 노출 더 자세히 ...

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

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

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

static void	FHivePromotion::GetViewInfo (const EHivePromotionCustomType &PromotionCustomType, const FString &ContentsKey, const FHivePromotionOnViewInfoDelegate &Delegate)
	HIVE 프로모션 웹 뷰의 UI 를 게임 UI 의 컨셉에 맞추기 위해서 프로모션 웹 뷰를 게임에서 직접 구현 할 수 있다 이 메서드는 게임에서 HIVE 프로모션 웹 뷰를 커스터 마이징하기 위한 정보를 반환한다. 더 자세히 ...

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

static void	FHivePromotion::GetBannerInfo (const EHivePromotionCampaignType &CampaignType, const EHivePromotionBannerType &BannerType, const FHivePromotionOnBannerInfoDelegate &Delegate)
	배너 정보 조회 특정 프로모션에 대한 배너 정보를 요청한다. 더 자세히 ...

static void	FHivePromotion::GetBannerInfoString (const FString &CampaignString, const FString &BannerString, const FHivePromotionOnBannerInfoDelegate &Delegate)
	배너 정보 조회 특정 프로모션에 대한 배너 정보를 요청한다. 더 자세히 ...

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

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

static TOptional< FHiveResultAPI >	FHivePromotion::SetEngagementReady (bool IsReady)
	Engagement 이벤트 처리가 가능한지(게임 서버에 DB가 생성된 경우 등) 여부를 설정한다. 더 자세히 ...

static bool	FHivePromotion::ProcessURI (const FString &URI)
	URI를 파싱하여 Event 타입으로 만든다. 더 자세히 ...

static void	FHivePromotion::SetEngagementDelegate (const FHivePromotionOnEngagementDelegate &Delegate)
	Engagement 리스너를 등록한다.

static void	FHivePromotion::ShowUAShare (const FString &InviteMessage, const FString &InviteLink, const FHivePromotionOnUAShareDelegate &Delegate)
	외부 SNS를 통해 UA url을 공유하기 위한 다이얼로그 노출 더 자세히 ...

static void	FHivePromotion::UpdatePromotionData ()
	/~korean Promotion 정보 갱신 Promotion 새소식 페이지 등의 노출에 필요한 정보를 갱신한다. 더 자세히 ...

static void	FHivePromotion::GetAppInvitationSenderInfo (const FHivePromotionOnAppInvitationSenderInfoDelegate &Delegate)
	UA를 통해 자신을 앱으로 최초 초대한 유저의 정보 반환 한다. 더 자세히 ...

상세한 설명

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

열거형 타입 문서화

◆ EHiveEngagementEventState

enum class EHiveEngagementEventState

strong

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

◆ EHiveEngagementEventType

enum class EHiveEngagementEventType

strong

UserEngagement 기능 타입

◆ EHiveOfferwallState

enum class EHiveOfferwallState

strong

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

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

◆ EHivePromotionBadgeTarget

enum class EHivePromotionBadgeTarget

strong

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

◆ EHivePromotionBannerType

enum class EHivePromotionBannerType

strong

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

◆ EHivePromotionCampaignType

enum class EHivePromotionCampaignType

strong

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

◆ EHivePromotionCustomType

enum class EHivePromotionCustomType

strong

커스텀 컨텐츠의 형태

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

◆ EHivePromotionEventType

enum class EHivePromotionEventType

strong

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

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

◆ EHivePromotionType

enum class EHivePromotionType

strong

프로모션 뷰 창의 형태

열거형 멤버
BANNER_LEGACY	전면배너
BANNER	전면배너
NEWS	새소식
NOTICE	공지사항

함수 문서화

◆ GetAppInvitationData()

static void FHivePromotion::GetAppInvitationData ( const FHivePromotionOnAppInvitationDataDelegate & Delegate )

static

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

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

매개변수

Delegate API 호출 결과.

◆ GetAppInvitationSenderInfo()

static void FHivePromotion::GetAppInvitationSenderInfo ( const FHivePromotionOnAppInvitationSenderInfoDelegate & Delegate )

static

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

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

매개변수

Delegate API 결과 통지 리스터

◆ GetBadgeInfo()

static void FHivePromotion::GetBadgeInfo ( const FHivePromotionOnBadgeInfoDelegate & Delegate )

static

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

매개변수

Delegate API 결과 통지

◆ GetBannerInfo()

static void FHivePromotion::GetBannerInfo	(	const EHivePromotionCampaignType &	CampaignType,
		const EHivePromotionBannerType &	BannerType,
		const FHivePromotionOnBannerInfoDelegate &	Delegate
	)

static

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

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

매개변수

CampaignType	"event", "notice", "all", "cross"
Delegate	API 결과 통지

◆ GetBannerInfoString()

static void FHivePromotion::GetBannerInfoString	(	const FString &	CampaignString,
		const FString &	BannerString,
		const FHivePromotionOnBannerInfoDelegate &	Delegate
	)

static

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

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

매개변수

CampaignString	커스텀 String campaign type
Delegate	API 결과 통지

◆ GetOfferwallState()

static EHiveOfferwallState FHivePromotion::GetOfferwallState ( )

static

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

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

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

◆ GetViewInfo()

static void FHivePromotion::GetViewInfo	(	const EHivePromotionCustomType &	PromotionCustomType,
		const FString &	ContentsKey,
		const FHivePromotionOnViewInfoDelegate &	Delegate
	)

static

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

매개변수

listener API 결과 통지

◆ ProcessURI()

static bool FHivePromotion::ProcessURI ( const FString & URI )

static

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

매개변수

URI 파싱할 URI

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

◆ SetAdditionalInfo()

static void FHivePromotion::SetAdditionalInfo ( const FString & AdditionalInfo )

static

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

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

매개변수

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

◆ SetEngagementReady()

static TOptional< FHiveResultAPI > FHivePromotion::SetEngagementReady ( bool IsReady )

static

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

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

매개변수

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

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

◆ ShowCustomContents()

static void FHivePromotion::ShowCustomContents	(	const EHivePromotionCustomType &	PromotionCustomType,
		const FString &	ContentsKey,
		const FHivePromotionViewDelegate &	Delegate
	)

static

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

매개변수

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

◆ ShowCustomContentsOnGameWindow()

static void FHivePromotion::ShowCustomContentsOnGameWindow	(	const EHivePromotionCustomType &	PromotionCustomType,
		const FString &	ContentsKey,
		const FHivePromotionViewDelegate &	Delegate
	)

static

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

매개변수

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

◆ ShowExit()

static void FHivePromotion::ShowExit ( const FHivePromotionViewDelegate & Delegate )

static

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

매개변수

listener API 결과 통지

◆ ShowNativeReview()

static void FHivePromotion::ShowNativeReview ( )

static

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

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

◆ ShowNews()

static void FHivePromotion::ShowNews	(	const FString &	Menu,
		const TArray< int32 > &	GiftPidList,
		const FHivePromotionViewDelegate &	Delegate
	)

static

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

매개변수

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

◆ ShowOfferwall()

static void FHivePromotion::ShowOfferwall ( const FHivePromotionViewDelegate & Delegate )

static

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

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

매개변수

Delegate API 결과 통지

◆ ShowPromotion()

static void FHivePromotion::ShowPromotion	(	const EHivePromotionType &	PromotionType,
		bool	IsForced,
		const FHivePromotionViewDelegate &	Delegate
	)

static

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

매개변수

PromotionType 프로모션 뷰 창의 형태

IsForced

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

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

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

Delegate API 결과 통지

◆ ShowReview()

static void FHivePromotion::ShowReview ( const FHivePromotionViewDelegate & Delegate )

static

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

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

◆ ShowUAShare()

static void FHivePromotion::ShowUAShare	(	const FString &	InviteMessage,
		const FString &	InviteLink,
		const FHivePromotionOnUAShareDelegate &	Delegate
	)

static

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

매개변수

InviteMessage	UA 초대 메시지
InviteLink	UA 초대 링크
Delegate	API 결과 통지 리스너

◆ UpdatePromotionData()

static void FHivePromotion::UpdatePromotionData ( )

static

/~korean Promotion 정보 갱신
Promotion 새소식 페이지 등의 노출에 필요한 정보를 갱신한다.

/~english Update information of Promotion Update promotion data to show Promotion UI.

HIVE SDK for Unreal Engine

클래스

열거형 타입

함수

상세한 설명

열거형 타입 문서화

◆ EHiveEngagementEventState

◆ EHiveEngagementEventType

◆ EHiveOfferwallState

◆ EHivePromotionBadgeTarget

◆ EHivePromotionBannerType

◆ EHivePromotionCampaignType

◆ EHivePromotionCustomType

◆ EHivePromotionEventType

◆ EHivePromotionType

함수 문서화

◆ GetAppInvitationData()

◆ GetAppInvitationSenderInfo()

◆ GetBadgeInfo()

◆ GetBannerInfo()

◆ GetBannerInfoString()

◆ GetOfferwallState()

◆ GetViewInfo()

◆ ProcessURI()

◆ SetAdditionalInfo()

◆ SetEngagementReady()

◆ ShowCustomContents()

◆ ShowCustomContentsOnGameWindow()

◆ ShowExit()

◆ ShowNativeReview()

◆ ShowNews()

◆ ShowOfferwall()

◆ ShowPromotion()

◆ ShowReview()

◆ ShowUAShare()

◆ UpdatePromotionData()