Skip to content

橫幅

此模組實現橫幅廣告的展示及清除。閱讀JOGOS_SDK 簡介頁面與您的遊戲引擎相關的部分後,可以按如下方式使用相關的功能:

javascript
window.JOGOS_SDK.banner;
廣告要求

請務必閱讀我們的廣告要求,因為如果您的遊戲不遵守這些要求,您的遊戲將被拒絕,且沒有任何反饋。

請求展示橫幅廣告

橫幅廣告共有 5 種尺寸可供選擇:

  • 排行榜 (728x90)
  • 中等(300x250)
  • 行動裝置(320x50)
  • 主頁 (468x60)
  • 大型行動裝置 (320x100)
限制
  • 同一時刻只能顯示 2 個尺寸不同的橫幅廣告
  • 同一橫幅廣告位置必須顯示 60 秒後,方可再次刷新廣告
  • 如果橫幅不遵循以上規則和尺寸,它很可能不會顯示

首先,您需要在螢幕上創建橫幅廣告的容器,可選的指定寬度和高度:

html
<div id="banner-container" style="width: 300px; height: 250px"></div>

然後使用以下方法請求顯示橫幅廣告(注意id需與容器的id保持一致):

javascript
try {
  await window.JOGOS_SDK.banner.requestBanner('banner-container');
} catch (e) {
  console.log('Banner request error', e);
}

同一時刻最多只能展示兩個橫幅廣告,否則會拋出異常:'500 At most two banners can be displayed at the same time'。

使用相同的id執行此方法,會替換原有廣告,在指定的時間內(一般為 60 秒)重複執行,會拋出異常:500 The time for each call to method requestBanner cannot exceed ${time} seconds

清除指定橫幅

然後使用以下方法可清除id為指定值的橫幅:

javascript
await window.JOGOS_SDK.banner.clearBanner('banner-container');

清除所有橫幅

然後使用以下方法可清除所有橫幅:

javascript
await window.JOGOS_SDK.banner.clearAllBanners();

本地測試

本地測試時,並不會展示真實的廣告,查看最終顯示效果可將您的遊戲打包上傳至開發者平台 QA 工具中進行測試。