오퍼월

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

오퍼월 구성하기¶

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

오퍼월 제공 여부 확인하기¶

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

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

using hive;    
    OfferwallState offerwallState = Promotion.getOfferwallState();    

    if (offerwallState == OfferwallState.ENABLED) {    
    // Offer wall button can be exposed    
    }    
    else {    
    // Offer wall button cannot be exposed    
}

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    OfferwallState offerwallState = Promotion::getOfferwallState();    

    if (offerwallState == OfferwallState::ENABLED) {    
        // Offer wall button can be exposed    
    }    
    else {    
        // Offer wall button cannot be exposed    
}

import com.hive.Promotion    
    val state = Promotion.offerwallState    
    if (state == Promotion.OfferwallState.ENABLED) {    
         // Offer wall button can be exposed    
    } else {    
         // Offer wall button cannot be exposed    
}

import com.hive.Promotion;    
    Promotion.OfferwallState state = Promotion.INSTANCE.getOfferwallState();    
    if (state == Promotion.OfferwallState.ENABLED) {    
         // Offer wall button can be exposed    
    } else {    
         // Offer wall button cannot be exposed    
}

import HIVEService    
    let offerwallState = PromotionInterface.getOfferwallState()    
    if (offerwallState == .enabled) {    
    // Offer wall button can be exposed    
    }    
    else {    
    // Offer wall button cannot be exposed    
}

#import <HIVEService/HIVEService-Swift.h>    
    HIVEOfferwallState offerwallState = [HIVEPromotion getOfferwallState];    

    if (offerwallState == HIVEOfferwallStateEnabled) {    
         // Offer wall button can be exposed    
    }    
    else {    
         // Offer wall button cannot be exposed    
}

오퍼월 버튼 노출하기¶

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

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

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

오퍼월 버튼 텍스트¶

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

오퍼월 웹뷰 호출하기¶

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

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

using hive;    
    Promotion.showOfferwall(ResultAPI result, PromotionEventType viewEventType) => {    
        if (result.isSuccess()) {    
        // call successful    
        }    
});

#include "HivePromotion.h"

FHivePromotion::ShowOfferwall(FHivePromotionViewDelegate::CreateLambda([this](const FHiveResultAPI& ResultAPI, const EHivePromotionEventType& PromotionEventType) {
        if (Result.IsSuccess()) {
                // API 호출 성공
        }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    Promotion::showOfferwall([=](ResultAPI result, PromotionEventType viewEventType) {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

import com.hive.Promotion    
    Promotion.showOfferwall(object : Promotion.PromotionViewListener {    
         override fun onPromotionView(result: ResultAPI, promotionEventType: Promotion.PromotionViewResultType) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

import com.hive.Promotion;    
    Promotion.INSTANCE.showOfferwall((result, viewResultType) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

import HIVEService    
    PromotionInterface.showOfferwall() { result, viewResultType in    
        if result.isSuccess() {    
        // call successful    
        }    
}

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEPromotion showOfferwall: ^(HIVEResultAPI *result, HIVEPromotionViewResultType viewResultType) {    
        if ([result isSuccess]) {    
            // call successful    
        }    
}];