오퍼월 – Hive Developers

오퍼월(Offerwall)은 Hive가 탑재된 게임 간의 광고 네트워크를 통해서 Hive 유저들이 새로운 Hive 게임을 이용하도록 유도하기 위한 서비스로서 Hive는 오퍼월을 통해 유저가 다운로드 받을 수 있는 게임 목록을 제공합니다. 보상이 있는 오퍼월에서는 해당 게임을 설치하면 받을 수 있는 보상 정보를 제공하며 유저가 게임을 다운로드 받아 설치하고 실행하면, Hive는 오퍼월을 표시했던 게임에서 유저에게 보상합니다.

보상이 있는 오퍼월

보상이 없는 오퍼월

오퍼월 구성하기

오퍼월은 Hive 콘솔에서 구성할 수 있습니다. 자세한 내용은 Hive 콘솔 프로모션 가이드를 참고하세요.

오퍼월 제공 여부 확인하기

새소식 페이지에 오퍼월 배너가 나타나지만 게임 내(게임 상점, 게임 로비 등)에서도 오퍼월에 접근할 수 있는 버튼이나 아이콘이 제공되어야 합니다. 하지만 일부 게임에서 오퍼월을 제공하지 않거나, 일시적으로 오퍼월 접근을 막아야 하는 문제가 발생할 수 있습니다. 이런 경우에는 오퍼월 버튼이나 아이콘을 표시하지 않거나 비활성화합니다. 오퍼월을 유저에게 제공할 수 있는지 확인하기 위해서는 Promotion 클래스의 getOfferwallState() 메서드를 호출합니다.

다음은 오퍼월 버튼을 제공할 수 있는지 확인하는 예제 코드입니다.

Unity®

API Reference: hive.Promotion.getOfferwallState

using hive;

OfferwallState offerwallState = Promotion.getOfferwallState(); 
 
if (offerwallState == OfferwallState.ENABLED) {
	// 오퍼월 버튼 노출 가능
}
else {
	// 오퍼월 버튼 노출 불가능
}

using hive;

OfferwallState offerwallState = Promotion.getOfferwallState();

if (offerwallState == OfferwallState.ENABLED) {

// 오퍼월 버튼 노출 가능

}

else {

// 오퍼월 버튼 노출 불가능

}

C++

API Reference: Promotion::getOfferwallState

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace std;
using namespace hive;

OfferwallState offerwallState = Promotion::getOfferwallState();
 
if (offerwallState == OfferwallState::ENABLED) {
   // 오퍼월 버튼 노출 가능
}
else {
   // 오퍼월 버튼 노출 불가능
}

#include <HIVE_SDK_Plugin/HIVE_CPP.h>

using namespace std;

using namespace hive;

OfferwallState offerwallState = Promotion::getOfferwallState();

if (offerwallState == OfferwallState::ENABLED) {

// 오퍼월 버튼 노출 가능

}

else {

// 오퍼월 버튼 노출 불가능

}

Kotlin

API Reference: Promotion.offerwallState

import com.hive.Promotion

val state = Promotion.offerwallState

if (state == Promotion.OfferwallState.ENABLED) {
    // 오퍼월 버튼 노출 가능
} else {
    // 오퍼월 버튼 노출 불가능
}

import com.hive.Promotion

val state = Promotion.offerwallState

if (state == Promotion.OfferwallState.ENABLED) {

// 오퍼월 버튼 노출 가능

} else {

// 오퍼월 버튼 노출 불가능

}

Java

API Reference: Promotion.INSTANCE.getOfferwallState

import com.hive.Promotion;

Promotion.OfferwallState state = Promotion.INSTANCE.getOfferwallState();

if (state == Promotion.OfferwallState.ENABLED) {
    // 오퍼월 버튼 노출 가능
} else {
    // 오퍼월 버튼 노출 불가능
}

import com.hive.Promotion;

Promotion.OfferwallState state = Promotion.INSTANCE.getOfferwallState();

if (state == Promotion.OfferwallState.ENABLED) {

// 오퍼월 버튼 노출 가능

} else {

// 오퍼월 버튼 노출 불가능

}

Swift

API Reference: PromotionInterface.getOfferwallState

import HIVEService

let offerwallState = PromotionInterface.getOfferwallState()

if (offerwallState == .enabled) {
	// 오퍼월 버튼 노출 가능
}
else {
	// 오퍼월 버튼 노출 불가능
}

import HIVEService

let offerwallState = PromotionInterface.getOfferwallState()

if (offerwallState == .enabled) {

// 오퍼월 버튼 노출 가능

}

else {

// 오퍼월 버튼 노출 불가능

}

Objective-C

API Reference: HIVEPromotion:getOfferwallState

#import <HIVEService/HIVEService-Swift.h>

HIVEOfferwallState offerwallState = [HIVEPromotion getOfferwallState]; 
 
if (offerwallState == HIVEOfferwallStateEnabled) {
    // 오퍼월 버튼 노출 가능
}
else {
    // 오퍼월 버튼 노출 불가능
}

#import <HIVEService/HIVEService-Swift.h>

HIVEOfferwallState offerwallState = [HIVEPromotion getOfferwallState];

if (offerwallState == HIVEOfferwallStateEnabled) {

// 오퍼월 버튼 노출 가능

}

else {

// 오퍼월 버튼 노출 불가능

}

오퍼월 버튼 노출하기

오퍼월 노출 가능 여부가 확인되었다면 오퍼월로 이동할 수 있는 버튼을 노출합니다.

보상이 있는 오퍼월(무료충전소) 버튼을 상점 내에 구현한 예시 화면

보상이 없는 오퍼월(추천 게임) 버튼을 게임 타이틀에 구현한 예시 화면

오퍼월 버튼 텍스트

오퍼월을 표기하는 방법은 각 언어별로 다음과 같습니다. 보상이 있는 오퍼월 표기 문구에서 [VC]에는 게임에서 제공하는 가상화폐(Virtual Currency)를 입력해주세요.

언어	보상이 있는 오퍼월 표기 문구	보상이 없는 오퍼월 표기 문구
한국어	무료 [VC] 받기	추천 게임
영어	Get Free [VC]	Suggested
일본어	無料[VC]ゲット	おすすめゲーム
중국어 간체	免费接受[VC]	游戏推荐
중국어 번체	免費接收[VC]	遊戲推薦
프랑스어	Recevoir gratuitement [VC]	Recommandé
독일어	[VC] gratis erhalten	Empfohlen
러시아어	Получить бесплатно [VC]	Рекомендуем
스페인어	Obtener [VC] gratis	Sugerido
포르투갈어	Obtenha [VC] grátis	Sugerido
인도네시아어	Ambil [VC] Gratis	Disarankan
말레이시아어	Terima [VC] Percuma	Disyorkan
베트남어	Nhận [VC] Miễn Phí	Đề Xuất
태국어	รับ [VC] ฟรี	แนะนำ
이탈리아어	[VC] gratis!	Consigliato
터키어	Ücretsiz [VC] Alın	Önerilen
아랍어	أحصل على [VC] مجانا	مقترح

오퍼월 웹뷰 호출하기

게임에서 오퍼월 웹뷰를 노출하려면 Promotion 클래스의 showOfferwall() 메서드를 호출하세요.

다음은 오퍼월 웹뷰를 노출하는 예제 코드입니다.

Unity®

API Reference: hive.Promotion.showOfferwall

using hive;

Promotion.showOfferwall(ResultAPI result, PromotionEventType viewEventType) => {   
	if (result.isSuccess()) {
		// 호출 성공
    }
});

using hive;

Promotion.showOfferwall(ResultAPI result, PromotionEventType viewEventType) => {

if (result.isSuccess()) {

// 호출 성공

}

});

C++

API Reference: Promotion::showOfferwall

#include <HIVE_SDK_Plugin/HIVE_CPP.h>
using namespace std;
using namespace hive;

Promotion::showOfferwall([=](ResultAPI result, PromotionEventType viewEventType) {
    if (result.isSuccess()) {
        // 호출 성공
    }
});

#include <HIVE_SDK_Plugin/HIVE_CPP.h>

using namespace std;

using namespace hive;

Promotion::showOfferwall([=](ResultAPI result, PromotionEventType viewEventType) {

if (result.isSuccess()) {

// 호출 성공

}

});

Kotlin

API Reference: Promotion.showOfferwall

import com.hive.Promotion

Promotion.showOfferwall(object : Promotion.PromotionViewListener {
    override fun onPromotionView(result: ResultAPI, promotionEventType: Promotion.PromotionViewResultType) {
        if (result.isSuccess) {
            // 호출 성공
        }
    }
})

import com.hive.Promotion

Promotion.showOfferwall(object : Promotion.PromotionViewListener {

override fun onPromotionView(result: ResultAPI, promotionEventType: Promotion.PromotionViewResultType) {

if (result.isSuccess) {

// 호출 성공

}

})

Java

API Reference: Promotion.INSTANCE.showOfferwall

import com.hive.Promotion;

Promotion.INSTANCE.showOfferwall((result, viewResultType) -> {
    if (result.isSuccess()) {
        // 호출 성공
    }
});

import com.hive.Promotion;

Promotion.INSTANCE.showOfferwall((result, viewResultType) -> {

if (result.isSuccess()) {

// 호출 성공

}

});

Swift

API Reference: PromotionInterface.showOfferwall

import HIVEService

PromotionInterface.showOfferwall() { result, viewResultType in 
	if result.isSuccess() {
		// 호출 성공
	}
}

import HIVEService

PromotionInterface.showOfferwall() { result, viewResultType in

if result.isSuccess() {

// 호출 성공

}

Objective-C

API Reference: HIVEPromotion showOfferwall

#import <HIVEService/HIVEService-Swift.h>

[HIVEPromotion showOfferwall: ^(HIVEResultAPI *result, HIVEPromotionViewResultType viewResultType) {
    if ([result isSuccess]) {
        // 호출 성공
    }
}];

#import <HIVEService/HIVEService-Swift.h>

[HIVEPromotion showOfferwall: ^(HIVEResultAPI *result, HIVEPromotionViewResultType viewResultType) {

if ([result isSuccess]) {

// 호출 성공

}

}];

오퍼월 구성하기

오퍼월 제공 여부 확인하기

오퍼월 버튼 노출하기

오퍼월 버튼 텍스트

오퍼월 웹뷰 호출하기

시작하기

SDK 개발

콘솔 가이드

다운로드

API 문서

지원