HIVE SDK for Unity3D

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

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

커스텀 컨텐츠의 형태

작성자

kjkim

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

작성자

ryuvsken

프로모션 뷰 창의 형태

작성자

ryuvsken

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

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

매개변수

listener

API 호출 결과.

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

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

매개변수

listener

API 결과 통지 리스터

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

매개변수

listener

API 결과 통지

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

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

매개변수

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

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

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

매개변수

campaignType	campaignType
bannerType	bannerType
handler	API 결과 통지

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

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

반환값

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

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

매개변수

listener

API 결과 통지

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

매개변수

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

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

매개변수

result	API 호출 결과
senderInfo	자신을 앱으로 최초로 초대 성공한 유저의 정보

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

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

매개변수

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

HIVE 프로모션 뱃지 정보 반환

매개변수

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

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

매개변수

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

프로모션 뷰 API 결과 통지

매개변수

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

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

매개변수

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

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

매개변수

URI

파싱할 URI

반환값

파싱에 문제가 없으면 true, 아니면 false.

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

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

매개변수

additionalInfo

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

Engagement 리스너를 등록한다.

매개변수

listener

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

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

매개변수

bReady

Enganement 이벤트 처리 가능 여부.

반환값

API 호출 성공 여부.

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

매개변수

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

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

매개변수

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

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

매개변수

listener

API 결과 통지

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

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

매개변수

listener

API 결과 통지

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

매개변수

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

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

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

매개변수

listener

API 결과 통지

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

매개변수

promotionType	프로모션 뷰 창의 형태
isForced	type이 "notice" 와 "event" 일 때만 동작 true일 경우 24시간 다시보지 않기를 무시한다. (주의:24시간 다시보기가 적용되지 않으므로 버튼 액션으로 보는 등 특정 액션에서만 사용해야 함.) false이거나 생략할 경우 24시간 안보기가 정상동작함.
listener	API 결과 통지

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

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

매개변수

listener

API 결과 통지

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

매개변수

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

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

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