動画広告

このモジュールでは、インタースティシャル動画広告とリワード動画広告を実装します。JOGOS_SDK 紹介ページおよびご使用のゲームエンジンに関連する部分を読み、以下の方法で動画広告の機能を使用してください：

window.JOGOS_SDK.ad;

広告要件

必ず広告要件をお読みください。これを遵守しない場合、ゲームは承認されず、フィードバックもありません。

動画広告の再生リクエスト

当社は2種類の動画広告をサポートしています：インタースティシャル広告（midgame）とリワード広告（rewarded）;

• インタースティシャル広告：ユーザーが死亡した場合やレベルクリア時などに、ゲーム状況に応じて表示可能。
• リワード広告：ユーザーが自発的にリワード広告を視聴して報酬を得る（追加ライフ、キャラクター死亡時の復活、追加アイテム、追加ステータスなど）。

// コールバック関数
const callbacks = {
  // 広告再生開始時に呼ばれる
  onstarted: () => console.log('ad started'),
  // 広告再生終了時に呼ばれる
  onfinished: () => console.log('ad finished'),
  // 広告再生中にエラーが発生した場合に呼ばれる
  onerror: (error) => console.log('ad error:', error),
};

// インタースティシャル広告表示リクエスト
window.JOGOS_SDK.ad.requestAd('midgame', callbacks);
// リワード広告表示リクエスト
window.JOGOS_SDK.ad.requestAd('rewarded', callbacks);

広告使用上の注意

• インタースティシャル広告には最小更新間隔があります（通常60秒）。頻繁に呼び出すと例外が発生します：500 At least a ${time} second interval is required to display new advertisements。

• リワード広告には1日あたりの最大制限があります（通常、ユーザー1日50回まで）。過剰に呼び出すと例外が発生します：500 You can only watch up to ${max} rewarded ads per day。

• リワード広告ポイントを設計する際は、クールダウン時間や1日あたりの上限回数を設定することを推奨します。以下のAPIを使用して、ユーザーの残りリワード広告回数を取得し、広告を非表示にするか判断することも可能です。

const result = await window.JOGOS_SDK.ad.getRewardAdCount();
console.log('Remaining rewardAd count ', result);

広告ブロック検知

広告要件

当社のゲーム設計では、ユーザーが広告ブロッカーを使用してもゲームを続行可能です。しかし、検知機構には誤検知の可能性があります。正常なユーザーへの影響を避けるため、制限は緩やかにし、広告ブロックユーザーにのみ有料コンテンツ（特別スキン、追加ステージなど）を制限し、ユーザーが広告ブロックを解除した後はページを更新するだけで完全な機能が回復するようにしてください。

ユーザーが広告ブロッカーを使用しているかどうかを検知するには、以下の方法を使用します：

const result = await window.JOGOS_SDK.ad.hasAdblock();
console.log('Adblock usage fetched', result);