Display interstitial banners

Hive SDK provides a interstitial banner to

• Expose events effectively to game users
• Encourage users for more participation in games

The banner defined by Hive means a Promotion view composed of a single image without letters. If the user clicks the banner, it take the user to the detail page, the external page, or the download page of the game being advertised according to the contents configured in the Hive Console. We recommend you to expose interstitial banner, which displays the banner image in full screen, when user enter the game lobby after login.

Registering a Interstitial Banner on Hive Console¶

Design the banner image according to the horizontal and vertical mode as follows, and register it on the Hive Console.  For more information about banner registration, see Guide for Hive Console Promotion.

• Promotion banner image sizes
  • Landscape mode: 1080x720 px
  • Portrait mode: 720x1080 px
• If you want to display high-resolution banners in a PC environment, please upload images of 2160x1440 px.

Displaying Interstitial Banners¶

• An example of a interstitial banner

To display a interstitial banner, call showPromotion() method from Promotion class with PromotionType.BANNER parameter. From Hive SDK v4.12.1, PromotionType.BANNER displays web-type banner, and other parameters display image view-type banner. When you call PromotionType.BANNERLEGACY, webview-type banner is displayed as usual.

When displaying a full banner with the PromotionType.BANNER type, the images stored asynchronously in the app's local storage during the Hive SDK initialization process will be displayed. If there are no cached images, the images will be downloaded immediately for display.

The "Don't show for n days." feature at the bottom of the front banner allows you to set a period of 1 to 7 days for not displaying the front banner when registered in the Hive console. The basis for stopping display is at midnight local time of the respective region when the date changes. For more details, please refer to the console promotion guide.

The followings are sample codes to display a interstitial banner.

using hive;    

PromotionType promotionViewType = PromotionType.BANNER;    

// isForced is ignored when PromotionType.BANNER
Boolean isForced = false;    

// Display a large banner    
Promotion.showPromotion(promotionViewType, isForced, (ResultAPI result, PromotionEventType viewEventType) => {    
     if (result.isSuccess()) {    
         // call successful    
     }    
});

#include "HivePromotion.h"

EHivePromotionType PromotionType = EHivePromotionType::BANNER;

// isForced is ignored when EHivePromotionType::BANNER   
bool bIsForced = false;

FHivePromotion::ShowPromotion(PromotionType, bIsForced, FHivePromotionViewDelegate::CreateLambda([this](const FHiveResultAPI& Result, const EHivePromotionEventType& PromotionEventType) {
        if (Result.IsSuccess()) {
                // call successful    
        }
}));

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

PromotionType promotionViewType = PromotionType::BANNER;    

// isForced is ignored when PromotionType::BANNER   
bool isForced = false;    

Promotion::showPromotion(promotionViewType, isForced, [=](ResultAPI result, PromotionEventType viewEventType) {    
    if (result.isSuccess()) {    
        // call successful    
     }    
});

import com.hive.Promotion;
import com.hive.ResultAPI;    

val promotionViewType = Promotion.PromotionViewType.BANNER    

// isForced is ignored when Promotion.PromotionViewType.BANNER   
val isForced = false    
Promotion.showPromotion(promotionViewType, isForced, object : Promotion.PromotionViewListener {    
     override fun onPromotionView(result: ResultAPI, promotionEventType: Promotion.PromotionViewResultType) {    
         if (result.isSuccess) {    
             // call successful    
         }    
     }    
})

import com.hive.Promotion;    
import com.hive.ResultAPI;    

Promotion.PromotionViewType promotionViewType = Promotion.PromotionViewType.BANNER;    
// isForced is ignored when Promotion.PromotionViewType.BANNER   
boolean isForced = false;    
Promotion.INSTANCE.showPromotion(promotionViewType, isForced, (result, promotionEventType) -> {    
     if (result.isSuccess()) {    
         // call successful    
     }    
});

import HIVEService 

let promotion: PromotionViewType = .banner    
// isForced is ignored when PromotionViewType.banner   
let isForced = false    
PromotionInterface.showPromotion(promotionViewType, isForced: isForced) { result, viewResultType in    
    if result.isSuccess() {    
    // call successful    
    }    
}

#import <HIVEService/HIVEService-Swift.h>    
HIVEPromotionViewType promotionViewType = HIVEPromotionViewTypeBANNER;    

// isForced is ignored when HIVEPromotionViewTypeBANNER   
BOOL isForced = NO;    

[HIVEPromotion showPromotion: promotionViewType isForced: isForced handler: ^(HIVEResultAPI *result, HIVEPromotionViewResultType viewResultType) {    
     if ([result isSuccess]) {    
          // call successful    
     }    
}];