Unity の動画リワード手動ロード実装
ironSource SDK の動画リワード広告は自動ロードだけでなく、手動ロードに設定することもできます。これを行うには、SDK の初期化の前にセッション全体のロードモードを設定する必要があります。これは、ironSource SDK 7.2.0+(ベータ 7.1.13 Android )からサポートされています。
ステップ1:動画リワード手動ロードイベント実装
ironSource Unity Plugin は広告のアベイラビリティステータスを通知するイベントを発火します。これらのイベントは動画リワード手動ロードを実装することでトリガーされる様になります。
こちらで解説されている動画リワードのイベントに加えて、手動ロード関連のイベントを以下のコード例に従って登録します。
// Add AdInfo Rewarded Video Events
IronSourceRewardedVideoEvents.onAdReadyEvent += RewardedVideoOnAdReadyEvent;
IronSourceRewardedVideoEvents.onAdLoadFailedEvent += RewardedVideoOnAdLoadFailedEvent;
IronSourceRewardedVideoEvents.onAdOpenedEvent += RewardedVideoOnAdOpenedEvent;
IronSourceRewardedVideoEvents.onAdClosedEvent += RewardedVideoOnAdClosedEvent;
IronSourceRewardedVideoEvents.onAdShowFailedEvent += RewardedVideoOnAdShowFailedEvent;
IronSourceRewardedVideoEvents.onAdRewardedEvent += RewardedVideoOnAdRewardedEvent;
IronSourceRewardedVideoEvents.onAdClickedEvent += RewardedVideoOnAdClickedEvent;
プラグインは、以下にリストされている全ての発生しうるイベントをリスナーに通知します:
/************* RewardedVideo AdInfo Delegates *************/
// Indicates that the Rewarded video ad was loaded successfully.
// AdInfo parameter includes information about the loaded ad
void RewardedVideoOnAdReadyEvent(IronSourceAdInfo adInfo) {}
// Indicates that the Rewarded video ad failed to be loaded
void RewardedVideoOnAdLoadFailedEvent(IronSourceError error) {}
// The Rewarded Video ad view has opened. Your activity will loose focus.
void RewardedVideoOnAdOpenedEvent(IronSourceAdInfo adInfo){}
// The Rewarded Video ad view is about to be closed. Your activity will regain its focus.
void RewardedVideoOnAdClosedEvent(IronSourceAdInfo adInfo){}
// The user completed to watch the video, and should be rewarded.
// The placement parameter will include the reward data.
// When using server-to-server callbacks, you may ignore this event and wait for the ironSource server callback.
void RewardedVideoOnAdRewardedEvent(IronSourcePlacement placement, IronSourceAdInfo adInfo){}
// The rewarded video ad was failed to show.
void RewardedVideoOnAdShowFailedEvent(IronSourceError error, IronSourceAdInfo adInfo){}
// Invoked when the video ad was clicked.
// This callback is not supported by all networks, and we recommend using it only if
// it's supported by all networks you included in your build.
void RewardedVideoOnAdClickedEvent(IronSourcePlacement placement, IronSourceAdInfo adInfo){}
ステップ2:動画リワード手動ロード設定
ironSource SDK を初期化する前に、動画リワード広告のロードモードを設定してください。この設定はセッション中継続します。
IronSource.Agent.setManualLoadRewardedVideo(bool isRewardedVideoManualAPI);
ステップ3:手動で動画リワード広告をロードする
ロードプロセスには時間がかかる場合があるため、ユーザーに表示する前に動画リワード広告をリクエストしてください。次の API を使用して広告をロードします。
IronSource.Agent.loadRewardedVideo();
完了!
ロードモードの手動モード設定が完了したら、こちらのガイドに従って動画リワードの実装を完了してください。