Offerwall

Offerwall is a service to provide opportunities for users to download and play diverse games linked to Hive SDK. Through advertisement among games, Hive SDK offers available game list on the offerwall. It informs rewards which user can receive when the player select a game on the offerwall with rewards and install the game. If the user downloads and installs the game, Hive SDK rewards the user for the game that displayed the offerwall.

Registering Offerwall¶

You can create offerwall on Hive Console. For more information, see Hive Console Promotion.

Checking Offerwall service¶

The game  (in game store, game lobby, etc.) must also provide a button or icon to access the offerwall, even though offerwall is shown up on news page.  However, in some games, you may not provide  Offerwall, or you may need to temporarily block access to the offerwall. In this case, you need to deactivate offerwall button or icon. To check whether offerwall can be provided or not, call getOfferwallState() method in the Promotion class.

Followings are sample codes to confirm whether you can provide offerwall button or not.

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    
}

Displaying Offerwall button¶

Once you have verified that the offerwall is available, display the button to move to the offerwall.

• An example of offerwall button with rewards on in-game shop

• An example of offerwall button without rewards on game title

Button text¶

Offerwall title for each language is as follows: Make sure to input the virtual currency of each game in [VC], for offerwall title with rewards only.

Displaying Offerwall view¶

To display offerwall view in game, call showOfferwall() method in the Promotion class..

Followings are sample codes to display offerwall view.

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 call success
        }
}));

#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    
        }    
}];