iOS の動画リワード手動ロード実装

ironSource SDK の動画リワード広告は自動ロードだけでなく、手動ロードに設定することもできます。これを行うには、SDK の初期化の前にセッション全体のロードモードを設定する必要があります。これは、ironSource SDK 7.2.0+ からサポートされています。

ステップ１：動画リワード手動ロード設定

ironSource SDK を初期化する前に、動画リワード広告のロードモードを設定してください。手動モードを設定すると同時に、新しいリスナー：ISRewardedVideoManualDelegate も実装します。

[IronSource setLevelPlayRewardedVideoManualDelegate:self];

このリスナーは、広告のアベイラビリティステータスと視聴完了を通知するコールバックをトリガーします。これにより、いつ広告を表示してユーザーに報酬を与えるべきかわかります。

SDK は、以下にリストされているすべての発生しうるイベントをリスナーに通知します：

+ (void)setLevelPlayRewardedVideoManualDelegate:(nullable id<LevelPlayRewardedVideoManualDelegate>)delegate;
#pragma mark - LevelPlayRewardedVideoManualDelegate
/**
 Called after an rewarded video has been loaded in manual mode
 @param adInfo The info of the ad.
 */
- (void)didLoadWithAdInfo:(ISAdInfo *)adInfo {}

/**
 Called after a rewarded video has attempted to load but failed in manual mode
 @param error The reason for the error
 */
- (void)didFailToLoadWithError:(NSError *)error {}

/**
 Called after a rewarded video has been viewed completely and the user is eligible for a reward.
 @param placementInfo An object that contains the placement's reward name and amount.
 @param adInfo The info of the ad.
 */
- (void)didReceiveRewardForPlacement:(ISPlacementInfo *)placementInfo withAdInfo:(ISAdInfo *)adInfo {}

/**
 Called after a rewarded video has attempted to show but failed.
 @param error The reason for the error
 @param adInfo The info of the ad.
 */
- (void)didFailToShowWithError:(NSError *)error andAdInfo:(ISAdInfo *)adInfo {}

/**
 Called after a rewarded video has been opened.
 @param adInfo The info of the ad.
 */
- (void)didOpenWithAdInfo:(ISAdInfo *)adInfo {}

/**
 Called after a rewarded video has been dismissed.
 @param adInfo The info of the ad.
 */
- (void)didCloseWithAdInfo:(ISAdInfo *)adInfo {}

/**
 Called after a rewarded video has been 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
 @param adInfo The info of the ad.
 */
- (void)didClick:(ISPlacementInfo *)placementInfo withAdInfo:(ISAdInfo *)adInfo {}

リスナーの完全な実装については、こちらで確認できます。

ステップ２：手動で動画リワード広告をロードする

ロードプロセスには時間がかかる場合があるため、ユーザーに表示する前に動画リワード広告をリクエストしてください。次の API を使用して広告をロードします：

+ (void)loadRewardedVideo;

アプリで複数の動画リワード広告を配信する場合は、前の動画リワード広告を表示して閉じた後で、この手順を繰り返す必要があります。 rewardedVideoDidClose コールバックがトリガーされると、新しい動画リワード広告をロード出来る様になります。

完了！

ロードモードの手動モード設定が完了したら、こちらのガイドに従って動画リワードの実装を完了してください。