显示插页广告
Hive SDK 提供了一個插頁式橫幅來
- 有效地向遊戲用戶曝光事件
- 鼓勵用戶更多地參與遊戲
- 作為交叉推廣來廣告其他遊戲並給予獎勵
由 Hive 定義的橫幅意味著一個由單一圖像組成的促銷視圖,沒有文字。如果用戶點擊橫幅,它會根據 Hive 控制台中配置的內容將用戶帶到詳細頁面、外部頁面或廣告遊戲的下載頁面。我們建議您在用戶登錄後進入遊戲大廳時展示插頁式橫幅,該橫幅在全屏中顯示橫幅圖像。
在 Hive 控制台上註冊插頁式橫幅¶
根據以下的橫向和縱向模式設計橫幅圖像,並在 Hive 控制台上註冊。 有關橫幅註冊的更多信息,請參閱 Hive 控制台促銷指南。
- 促銷橫幅圖片尺寸
- 橫向模式:1080x720 像素
- 縱向模式:720x1080 像素
- 如果您想在 PC 環境中顯示高解析度的橫幅,請上傳 2160x1440 像素的圖片。
顯示插頁式橫幅¶
- 一個插頁廣告的範例
要顯示插頁式橫幅,請從Promotion類別中調用showPromotion()
方法,並使用PromotionType.BANNER
參數。從Hive SDK v4.12.1開始,PromotionType.BANNER
顯示網頁類型的橫幅,而其他參數則顯示圖像視圖類型的橫幅。當您調用PromotionType.BANNERLEGACY
時,將如往常一樣顯示網頁視圖類型的橫幅。
當顯示類型為PromotionType.BANNER
的完整橫幅時,在Hive SDK初始化過程中異步存儲在應用程序本地存儲中的圖像將會顯示。如果沒有緩存的圖像,則會立即下載圖像以供顯示。
底部橫幅的「不顯示 n 天」功能允許您在 Hive 控制台註冊時設置 1 到 7 天的期間,以便在日期變更時不顯示前端橫幅。停止顯示的基準是在當地時間的午夜。欲了解更多詳情,請參閱控制台促銷指南。
Note
PromotionType.BANNER
類型不支持 isForced
選項。
以下是顯示插頁廣告的範例代碼。
API 參考: hive.Promotion.showPromotion
#include "HivePromotion.h"
EHivePromotionType PromotionType = EHivePromotionType::BANNER;
// 當 EHivePromotionType::BANNER 時,isForced 被忽略
bool bIsForced = false;
FHivePromotion::ShowPromotion(PromotionType, bIsForced, FHivePromotionViewDelegate::CreateLambda([this](const FHiveResultAPI& Result, const EHivePromotionEventType& PromotionEventType) {
if (Result.IsSuccess()) {
// call successful
}
}));
API 參考: Promotion::showPromotion
#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
}
});
API 參考: Promotion.showPromotion
import com.hive.Promotion;
import com.hive.ResultAPI;
val promotionViewType = Promotion.PromotionViewType.BANNER
// 當 Promotion.PromotionViewType.BANNER 時,isForced 會被忽略
val isForced = false
Promotion.showPromotion(promotionViewType, isForced, object : Promotion.PromotionViewListener {
override fun onPromotionView(result: ResultAPI, promotionEventType: Promotion.PromotionViewResultType) {
if (result.isSuccess) {
// 呼叫成功
}
}
})
API 參考: com.hive.Promotion.showPromotion
import com.hive.Promotion;
import com.hive.ResultAPI;
Promotion.PromotionViewType promotionViewType = Promotion.PromotionViewType.BANNER;
// 當 Promotion.PromotionViewType.BANNER 時,isForced 被忽略
boolean isForced = false;
Promotion.INSTANCE.showPromotion(promotionViewType, isForced, (result, promotionEventType) -> {
if (result.isSuccess()) {
// 呼叫成功
}
});
API 參考: PromotionInterface.showPromotion
API 參考: HIVEPromotion::showPromotion
#import <HIVEService/HIVEService-Swift.h>
HIVEPromotionViewType promotionViewType = HIVEPromotionViewTypeBANNER;
// 當 HIVEPromotionViewTypeBANNER 時,isForced 被忽略
BOOL isForced = NO;
[HIVEPromotion showPromotion: promotionViewType isForced: isForced handler: ^(HIVEResultAPI *result, HIVEPromotionViewResultType viewResultType) {
if ([result isSuccess]) {
// call successful
}
}];
控制跨推廣的插頁橫幅¶
當你呼叫showPromotion()
方法時,所有先前註冊的插頁廣告將會顯示。從Hive SDK v4 24.2.0開始,你可以選擇是否顯示交叉推廣插頁廣告。
如果在调用 showPromotion()
方法之前调用 Configuration.setCrossPromotionBannerShowing(false)
,则在应用程序启动时将不会显示交叉推广插页式横幅。如果使用 true
调用它,则会显示横幅。此方法在应用程序处于活动状态时会持续影响应用程序,因此只需在 Hive SDK 初始化后并在调用 showPromotion()
方法之前调用一次即可。您可以在应用程序处于活动状态时通过再次调用此方法并传入不同的值(true
或 false
)来更改横幅的可见性。
Note
當透過點擊橫幅使用showCustomContents()
方法顯示交叉推廣全廣告時,這也會受到對Configuration.setCrossPromotionBannerShowing()
的調用影響。
#import <HIVEService/HIVEService-Swift.h>
// 設定交叉推廣插頁式廣告不顯示 (false)
[HIVEConfiguration setCrossPromotionBannerShowing:false];
// 返回交叉推广插页式横幅显示的状态
BOOL crossPromotionBannerShowing = [HIVEConfiguration getCrossPromotionBannerShowing];
#import <HIVEService/HIVEService-Swift.h>
// 設定交叉推廣插頁式廣告不顯示 (false)
[HIVEConfiguration setCrossPromotionBannerShowing:false];
// 返回交叉促销插页广告显示的状态
BOOL crossPromotionBannerShowing = [HIVEConfiguration getCrossPromotionBannerShowing];