バナー
このモジュールはバナー広告の表示と削除を実装しています。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);
}
同一時刻に表示できるバナー広告は最大 2 つです。それ以外の場合は例外がスローされます:'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 ツールにアップロードしてテストしてください。