iOS でのリワード広告の実装

iOS アプリケーションにリワード広告を実装します。広告コンテンツをロードし、Objective-C または Swift コードを使用して表示し、デリゲートを使用して広告イベントと報酬ロジックを管理します。

読み終わるまでの所要時間 5 分

最終更新 7日前

広告を視聴したプレイヤーに報酬を与えると、ユーザーエンゲージメントが向上し、収益の増加につながります。例えば、ユーザーに与える報酬には、ゲーム内通貨、消耗品、追加のライフ、経験値の倍増などがあります。リワード広告を効果的にデザインする方法の詳細については、収益化戦略ガイドを参照してください。

動画リワード広告ロード例

UADSLoadConfigurationBuilder

を使用して、配置 ID、メディエーションメタデータ、入札用の任意の広告マークアップを含むロードリクエストを作成し、それを

UADSRewardedAd.load()

に渡します。completion ブロックは、成功したときにロードされた

UADSRewardedAd

インスタンスを受け取ります。後で広告を表示する必要があるため保持します。失敗した場合はエラーオブジェクトを表示します。

広告が表示されない場合、広告はロード後に設定した時間が経過すると期限切れになります。ロードされた広告インスタンスに

onAdExpired

を割り当ててこれを検出します。期限切れのリワード広告を

show()

しようとすると失敗します。リワード広告は多くの場合、プリロードされ、ユーザーがリワードをリクエストするまで保持されるため、これは特に重要です。コールバックを使用して、保存されたリファレンスを消去し、新しい

load()

呼び出しを発行します。これにより、必要なときに新しい広告が準備できます。


@プロパティ（強）UADSRewardedAd *rewardedAd;UADSLoadConfigurationBuilder *builder =    [[UADSLoadConfigurationBuilder alloc] initWithPlacementId:placementId];builder = [builder withMediationInfo:self.mediationInfo];builder = [builder withAdMarkup:bidResponse];[UADSRewardedAd ロード：[ビルダービルド]]        completion:^(UADSRewardedAd *ad, id<UnityAdsError> error) {    if (error) {        // Handle error    } else {                __weak typeof(self) weakSelf = self;         ad.onAdExpired = ^(UnityAd *expiredAd) {          weakSelf.rewardedAd = nil;          // reload here        };    }}];


var rewardedAd:UADSRewardedAd?let config = UADSLoadConfigurationBuilder(placementId: placementId)  .with(mediationInfo: mediationInfo)  .with(adMarkup: bidResponse)  .build()UADSRewardedAd.load(config) { ad, error in  if let error = error {      // Handle error  } else {      self.rewardedAd = ad      ad?.onAdExpired = { [weak self] _ in      self?.rewardedAd = nil      // reload here      }  }}

動画リワード広告の表示と報酬処理の例

保持された

UADSRewardedAd

のインスタンスで

show()

を呼び出し、表示ビューコントローラーで構築された

UADSShowConfiguration

と

UADSRewardedShowDelegate

を渡します。標準の

showDidStart

、

showDidClick

、

showDidComplete

、

showDidFail

のコールバックに加えて、デリゲートはユーザーが報酬を獲得したときに発生する専用の

showDidReceiveReward

コールバックを提供します。条件付きの完了状態チェックを避けるために、

showDidComplete

ではなく

showDidReceiveReward

で報酬を付与します。


@インターフェース MyDelegate ：NSObject <UADSRewardedShowDelegate>@end@implementation MyDelegate- (void)showDidStart:(UADSRewardedAd *)unityAd {}- (void)showDidClick:(UADSRewardedAd *)unityAd {}- (void)showDidComplete:(UADSRewardedAd *)unityAd                  with:(UADSShowFinishState)finishState {}- (void)showDidFail:(UADSRewardedAd *)unityAd            error:(id<UnityAdsError>)error {}- (void)showDidReceiveReward:(UADSRewardedAd *)unityAd {  // reward callback}@endUADSShowConfigurationBuilder *builder =[[UADSShowConfigurationBuilder alloc] init];builder = [builder withViewController:viewController];[self.rewardedAd show:[builder build] delegate:delegate];


クラス MyDelegate：NSObject, UADSRewardedShowDelegate {func showDidStart(_ unityAd:UADSRewardedAd) {}func showDidClick(_ unityAd:UADSRewardedAd) {}func showDidComplete()    _ unityAd:UADSRewardedAd,    finishState でUADSShowFinishState) {}func showDidFail(    _ unityAd:UADSRewardedAd,    error：UnityAdsError) {}func showDidReceiveReward(_ unityAd:UADSRewardedAd) {    // reward callback  }}let config = UADSShowConfigurationBuilder()  .with(viewController: viewController)  .build()rewardedAd?.show(config, delegate: delegate)

次のステップ: 実装を拡張するには、iOS でのバナー広告の実装を参照してください。

ドキュメント

Development

User Acquisition

Monetization

産業