显示插页广告

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 初始化過程中異步存儲在應用程序本地存儲中的圖像。如果沒有緩存的圖像，則會立即下載圖像以進行顯示。

從 Hive SDK v4 24.2.0 開始，插頁廣告底部的「今天不顯示」功能將更改為「n 天內不顯示」。在 Hive 控制台註冊插頁廣告時，您可以設置不顯示的持續時間為 1 到 7 天。未顯示的標準是在日期變更時各自區域的當地時間午夜。欲了解更多詳情，請參閱 Hive 控制台促銷指南。

以下是顯示插頁廣告的範例代碼。

Unity虛幻引擎C++KotlinJavaSwiftObjective-C

API 參考: hive.Promotion.showPromotion

using hive;    
    PromotionType promotionViewType = PromotionType.BANNER;    

    // 如果為真，則不會顯示「今天不再觀看」按鈕。即使用戶已經設置為今天不再顯示，它也會被忽略，並顯示插頁廣告。    
    Boolean isForced = false;    

    // 顯示插頁式橫幅    
    Promotion.showPromotion(promotionViewType, isForced, (ResultAPI result, PromotionEventType viewEventType) => {    
         if (result.isSuccess()) {    
             // 呼叫成功    
         }    
});

#include "HivePromotion.h"

EHivePromotionType PromotionType = EHivePromotionType::BANNER;

 // 如果為真，則不會顯示“今天不再觀看”按鈕。即使用戶已經設置為今天不再顯示，它也會被忽略，並顯示插頁廣告橫幅。
bool bIsForced = false;

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

API 參考: Promotion::showPromotion

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    PromotionType promotionViewType = 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    
    // 如果為真，則“今天不再觀看”按鈕將不會顯示。即使用戶已經設置為今天不再顯示，也會被忽略，並顯示插頁式橫幅。    
    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;    
    // 如果為真，則「今天不再觀看」按鈕將不會顯示。即使用戶已經設置為今天不再顯示，也會被忽略，並顯示插頁式橫幅。    
    boolean isForced = false;    
    Promotion.INSTANCE.showPromotion(promotionViewType, isForced, (result, promotionEventType) -> {    
         if (result.isSuccess()) {    
             // 呼叫成功    
         }    
});

API 參考: PromotionInterface.showPromotion

import HIVEService    
    let promotion: PromotionViewType = .banner    
    // 如果為真，則不會顯示「今天不再觀看」按鈕。即使用戶已經設置為今天不再顯示，它也會被忽略，並顯示插頁式橫幅。    
    let isForced = false    
    PromotionInterface.showPromotion(promotionViewType, isForced: isForced) { result, viewResultType in    
    if result.isSuccess() {    
    // 呼叫成功    
    }    
}

API 參考: HIVEPromotion::showPromotion

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

    // 如果為真，則不會顯示「今天不再觀看」按鈕。即使用戶已經設置為今天不再顯示，它也會被忽略，並顯示插頁廣告。    
    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()的調用影響。

UnityC++KotlinJavaSwiftObjective-C

using hive;

// 設定交叉推廣插頁式廣告不顯示 (false)
Configuration.setCrossPromotionBannerShowing(false);

// 返回交叉推广插页式横幅显示的状态
Boolean crossPromotionBannerShowing = Configuration.getCrossPromotionBannerShowing();

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

// 設定交叉推廣插頁式廣告不顯示 (false)
Configuration::setCrossPromotionBannerShowing(false);

// 返回交叉推广插页式广告显示的状态
bool crossPromotionBannerShowing = Configuration::getCrossPromotionBannerShowing();

import com.hive.Configuration

// 設定交叉推廣插頁式廣告不顯示 (false)
Configuration.setCrossPromotionBannerShowing(false)

// 返回交叉推广插页广告显示的状态
val crossPromotionBannerShowing = Configuration.getCrossPromotionBannerShowing()

import com.hive.Configuration;

// 設定交叉推廣插頁式廣告不顯示 (false)
Configuration.INSTANCE.setCrossPromotionBannerShowing(false);

// 返回交叉推广插页广告显示的状态
boolean crossPromotionBannerShowing = Configuration.INSTANCE.getCrossPromotionBannerShowing();

import HIVEService

// 設定交叉推廣插頁廣告不顯示 (false)
ConfigurationInterface.setCrossPromotionBannerShowing(false)

// 返回交叉推广插页广告显示的状态
var crossPromotionBannerShowing: Bool = ConfigurationInterface.getCrossPromotionBannerShowing()

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

显示插页广告

在 Hive 控制台上註冊插頁式橫幅¶

顯示插頁式橫幅¶

控制跨推廣的插頁橫幅¶