インタースティシャルバナーの表示

Hive SDKは、インタースティシャルバナーを提供します

• ゲームユーザーに効果的にイベントを公開する
• ユーザーのゲームへの参加を促す

Hiveによって定義されたバナーは、文字のない単一の画像で構成されたプロモーションビューを意味します。ユーザーがバナーをクリックすると、Hiveコンソールに設定された内容に応じて、詳細ページ、外部ページ、または広告されているゲームのダウンロードページにユーザーが移動します。ログイン後にユーザーがゲームロビーに入るときに、バナー画像を全画面で表示するインタースティシャルバナーを表示することをお勧めします。

Hive コンソールでインタースティシャルバナーを登録する¶

バナー画像を横向きおよび縦向きモードに従ってデザインし、Hive コンソールに登録してください。バナー登録に関する詳細は、Hive コンソールプロモーションのガイドを参照してください。

• プロモーションバナーの画像サイズ
  • 横向きモード: 1080x720 px
  • 縦向きモード: 720x1080 px
• PC環境で高解像度のバナーを表示したい場合は、2160x1440 pxの画像をアップロードしてください。

インタースティシャルバナーの表示¶

• インタースティシャルバナーの例

インタースティシャルバナーを表示するには、PromotionクラスのshowPromotion()メソッドをPromotionType.BANNERパラメータで呼び出します。Hive SDK v4.12.1以降、PromotionType.BANNERはウェブタイプのバナーを表示し、他のパラメータは画像ビュータイプのバナーを表示します。PromotionType.BANNERLEGACYを呼び出すと、ウェブビュータイプのバナーが従来通り表示されます。

PromotionType.BANNERタイプのフルバナーを表示する際、Hive SDKの初期化プロセス中にアプリのローカルストレージに非同期で保存された画像が表示されます。キャッシュされた画像がない場合、画像はすぐにダウンロードされて表示されます。

フロントバナーの下にある「n日間表示しない」機能では、Hive コンソールに登録されているときにフロントバナーを表示しない期間を1日から7日まで設定できます。表示を停止する基準は、日付が変更される際の各地域の現地時間の真夜中です。詳細については、コンソールプロモーションガイドを参照してください。

以下は、インタースティシャルバナーを表示するためのサンプルコードです。

using hive;    

PromotionType promotionViewType = PromotionType.BANNER;    

// isForcedはPromotionType.BANNERのときは無視されます
Boolean isForced = false;    

// 大きなバナーを表示    
Promotion.showPromotion(promotionViewType, isForced, (ResultAPI result, PromotionEventType viewEventType) => {    
     if (result.isSuccess()) {    
         // 成功を呼び出す    
     }    
});

#include "HivePromotion.h"

EHivePromotionType PromotionType = EHivePromotionType::BANNER;

// isForcedは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は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はPromotion.PromotionViewType.BANNERのとき無視されます   
val isForced = false    
Promotion.showPromotion(promotionViewType, isForced, object : Promotion.PromotionViewListener {    
     override fun onPromotionView(result: ResultAPI, promotionEventType: Promotion.PromotionViewResultType) {    
         if (result.isSuccess) {    
             // 成功した場合の呼び出し    
         }    
     }    
})

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

Promotion.PromotionViewType promotionViewType = Promotion.PromotionViewType.BANNER;    
// isForcedはPromotion.PromotionViewType.BANNERのときは無視されます   
boolean isForced = false;    
Promotion.INSTANCE.showPromotion(promotionViewType, isForced, (result, promotionEventType) -> {    
     if (result.isSuccess()) {    
         // 成功した場合の呼び出し    
     }    
});

import HIVEService 

let promotion: PromotionViewType = .banner    
// isForcedはPromotionViewType.bannerのときは無視されます   
let isForced = false    
PromotionInterface.showPromotion(promotionViewType, isForced: isForced) { result, viewResultType in    
    if result.isSuccess() {    
    // 成功した場合の呼び出し    
    }    
}

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

// isForcedはHIVEPromotionViewTypeBANNERの時に無視されます   
BOOL isForced = NO;    

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