コンテンツにスキップ

モジュール： 広告

目次

機能

機能

isEnabled

▸ isEnabled(): boolean

現在のセッションで広告が有効かどうかを返します。これにより、広告やリワード広告のボタンを表示するか、または別のフローを使用するかを判断できます。

例

if (Wortal.ads.isEnabled()) {
   // リワード広告のボタンを表示する
}

Returns

boolean

現在のセッションで広告が有効であれば True。広告が無効であれば False。

isAdBlocked

▸ isAdBlocked(): boolean

現在のセッションで広告がブロックされているかどうかを返します。こちらを使用することで、広告を表示する代わりに代替フローを使用するかどうかを選択したり、プレイヤーに広告ブロッカーを無効にするよう促したりすることが可能です。

Example

if (Wortal.ads.isAdBlocked()) {
   // Show a message to the player to disable their ad blocker.
   // Or use an alternative flow that doesn't require ads - social invites for rewards as an example.
}

Returns

boolean

現在のセッションで広告がブロックされている場合は true。ブロックされていない場合は false。

showInterstitial

▸ showInterstitial(placement, description, beforeAd, afterAd, noFill?): void

インタースティシャル広告の表示。こちらの広告は、レベルの達成や切り替えの合間に表示が可能です。

例

// プレイヤーがレベルを達成。
Wortal.ads.showInterstitial('next', 'NextLevel', pauseGame, resumeGame);

// プレイヤーがゲームを一時停止。
Wortal.ads.showInterstitial('pause', 'PausedGame', pauseGame, resumeGame);

// プレイヤーがアプリ内課金ページにアクセス。
Wortal.ads.showInterstitial('browse', 'BrowseShop', pauseAudio, resumeAudio);

パラメーター

名前 タイプ 内容説明
placement PlacementType 広告のプレースメントタイプ。
description string プレースメントの説明。
beforeAd () => void 広告が表示される前のコールバック。この時、ゲームを一時停止してください。
afterAd () => void 広告が表示された後のコールバック。この時、ゲームを再開してください。
noFill? () => void 広告が埋まらなかった場合のコールバック。このようなことは、プラットフォームに表示する広告がない場合、またはレート制限に達した場合などに発生する可能性があります。この場合、afterAd のコールバックが使用されます。

Returns

void

Throws

  • INVALID_PARAM

showRewarded

▸ showRewarded(description, beforeAd, afterAd, adDismissed, adViewed, noFill?): void

リワード広告の表示。プレイヤーが動画広告を最後まで視聴するなどの条件を満たした場合に、報酬を与える広告タイプです。必ずプレイヤーに通知し、許可を受けてから表示する必要があります。

例

// この例では、広告の条件達成とは関係なく、ゲームが進みます。
// 例：プレイヤーは広告を視聴することでボーナスコインを取得できますが、その結果に関わらずゲームは続行されます。
Wortal.ads.showRewarded('BonusCoins', pauseGame, resumeGame, skipBonus, addBonusCoins);

// この例では、広告の条件達成と関係して、ゲームが進みます。
// 例：プレイヤーはゲームオーバーの際、広告を視聴することで復活できますが、広告をスキップするとそのレベルを失います。
Wortal.ads.showRewarded('ReviveAndContinue', pauseAudio, resumeAudio, endGame, continueGame);

パラメーター

名前 タイプ 内容説明
description string プレースメントの説明。
beforeAd () => void 広告が表示される前のコールバック。この時、ゲームを一時停止してください。
afterAd () => void 広告が表示された後のコールバック。この時、ゲームを再開してください。
adDismissed () => void プレイヤーが動画広告を最後まで視聴しなかった場合のコールバック。この時、報酬は与えないでください。
adViewed () => void プレイヤーが動画広告を最後まで視聴した場合のコールバック。この時、報酬を与えてください。
noFill? () => void 広告が埋まらなかった場合のコールバック。これは、プラットフォームに表示する広告がない場合、またはレート制限に達した場合に発生する可能性があります。この場合、afterAd のコールバックが使用されます。

Returns

void

Throws

  • INVALID_PARAM