動画広告

このモジュールはインタースティシャル動画とリワード動画広告を実装します。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 人あたり 30 回）があり、過度に呼び出すと次の例外が発生します：500 You can only watch up to ${max} rewarded ads per day。

• リワード広告ポイントを設計する際には、広告ポイントにクールダウン時間または 1 日あたりの制限回数を設計することをお勧めします。また、次のインターフェースを使用して、現在のユーザーのリワード広告の残り回数を取得し、リワード広告を非表示にする必要があるかどうかを決定することもできます。

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