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);
}

同一時刻に表示できるバナー広告は最大 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 ツールにアップロードしてテストしてください。