このページは Cloud Translation API によって翻訳されました。

リワード広告

リワード広告は、ユーザーが広告を操作することと引き換えにのアプリ内報酬を獲得しましょう。このガイドアドマネージャーのリワード広告を統合することもできます

前提条件

Google Mobile Ads SDK 8.0.0 以降
スタートガイドを完了している。

必ずテスト広告でテストする

アプリを作成、テストする際は、テスト広告ではなく、配信します。実際の広告を使用すると、アカウントが停止される可能性があります。

テスト広告を読み込むには、iOS 向けのテスト専用広告ユニット ID を使う方法が最も簡単ですリワード広告:

/6499/example/rewarded

すべてのリクエストに対してテスト広告を返すように特別に構成されており、独自のアプリでコーディング、テスト、デバッグの際に自由に使用できます。作成したばかりのアプリを公開する前に、必ずご自身の広告ユニット ID に置き換えてください。

Mobile Ads SDK のテスト広告の仕組みについて詳しくは、テスト広告の仕組みに関するページ広告。

実装

リワード広告を統合する主な手順は次のとおりです。

広告を読み込む
[省略可] SSV コールバックを検証する
コールバックに登録する
広告を表示して報酬イベントを処理する

広告を読み込む

広告の読み込みは、静的な次に対する loadWithAdUnitID:request:completionHandler: メソッド: GADRewardedAd クラス。読み込みメソッドでは、広告ユニット ID、 GAMRequest オブジェクト、完了ハンドラこれは、広告の読み込みが成功または失敗したときに呼び出されます。読み込まれた GADRewardedAd オブジェクトは、完了時にパラメータとして提供されます。使用します。次の例は、GADRewardedAd を読み込む方法を示しています。 ViewController クラス。

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  private var rewardedAd: GADRewardedAd?

  func loadRewardedAd() {
    do {
      rewardedAd = try await GADRewardedAd.load(
        withAdUnitID: "/6499/example/rewarded", request: GAMRequest())
    } catch {
      print("Rewarded ad failed to load with error: \(error.localizedDescription)")
    }
  }
}

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()

@property(nonatomic, strong) GADRewardedAd *rewardedAd;

@end

@implementation ViewController
- (void)loadRewardedAd {
  GAMRequest *request = [GAMRequest request];
  [GADRewardedAd
      loadWithAdUnitID:@"/6499/example/rewarded"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        NSLog(@"Rewarded ad loaded.");
      }];
}

[省略可] サーバー側の検証（SSV）コールバックを検証する

サーバーサイドで追加データを必要とするアプリ確認コールバックでは、リワード広告のカスタムデータ機能を使用します。リワード広告に設定されている文字列値 SSV コールバックの custom_data クエリパラメータに渡されます。「いいえ」の場合カスタムデータ値が設定されている場合、custom_data クエリパラメータ値は SSV コールバックに含まれます。

次のコードサンプルは、リワード広告にカスタムデータを設定する方法を示しています。オブジェクトを宣言する必要があります。

Swift

do {
  rewardedAd = try await GADRewardedAd.load(
    withAdUnitID: "/6499/example/rewarded", request: GAMRequest())
  let options = GADServerSideVerificationOptions()
  options.customRewardString = "SAMPLE_CUSTOM_DATA_STRING"
  rewardedAd.serverSideVerificationOptions = options
} catch {
  print("Rewarded ad failed to load with error: \(error.localizedDescription)")
}

Objective-C

[GADRewardedAd
     loadWithAdUnitID:@"/6499/example/rewarded"
              request:[GAMRequest request];
    completionHandler:^(GADRewardedAd *ad, NSError *error) {
      if (error) {
        // Handle Error
        return;
      }
      self.rewardedAd = ad;
      GADServerSideVerificationOptions *options =
          [[GADServerSideVerificationOptions alloc] init];
      options.customRewardString = @"SAMPLE_CUSTOM_DATA_STRING";
      ad.serverSideVerificationOptions = options;
    }];

コールバックに登録する

プレゼンテーションイベントの通知を受け取るには、 GADFullScreenContentDelegate プロトコルを使用し、返された広告の fullScreenContentDelegate プロパティ。「 GADFullScreenContentDelegate プロトコルは、広告が成功または失敗したか、閉じられたかを示します。次のコードは、プロトコルを実装して広告に割り当てる方法を示しています。

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADFullScreenContentDelegate {

  private var rewardedAd: GADRewardedAd?

  func loadRewardedAd() {
    do {
      rewardedAd = try await GADRewardedAd.load(
        withAdUnitID: "/6499/example/rewarded", request: GAMRequest())
      rewardedAd?.fullScreenContentDelegate = self
    } catch {
      print("Rewarded ad failed to load with error: \(error.localizedDescription)")
    }
  }

  /// Tells the delegate that the ad failed to present full screen content.
  func ad(_ ad: GADFullScreenPresentingAd, didFailToPresentFullScreenContentWithError error: Error) {
    print("Ad did fail to present full screen content.")
  }

  /// Tells the delegate that the ad will present full screen content.
  func adWillPresentFullScreenContent(_ ad: GADFullScreenPresentingAd) {
    print("Ad will present full screen content.")
  }

  /// Tells the delegate that the ad dismissed full screen content.
  func adDidDismissFullScreenContent(_ ad: GADFullScreenPresentingAd) {
    print("Ad did dismiss full screen content.")
  }
}

Objective-C

@interface ViewController () <GADFullScreenContentDelegate>

@property(nonatomic, strong) GADRewardedAd *rewardedAd;

@end

@implementation ViewController
- (void)loadRewardedAd {
  GAMRequest *request = [GAMRequest request];
  [GADRewardedAd
      loadWithAdUnitID:@"ca-app-pub-3940256099942544/4806952744"
                request:request
      completionHandler:^(GADRewardedAd *ad, NSError *error) {
        if (error) {
          NSLog(@"Rewarded ad failed to load with error: %@", [error localizedDescription]);
          return;
        }
        self.rewardedAd = ad;
        NSLog(@"Rewarded ad loaded.");
        self.rewardedAd.fullScreenContentDelegate = self;
      }];
}

/// Tells the delegate that the ad failed to present full screen content.
- (void)ad:(nonnull id<GADFullScreenPresentingAd>)ad
    didFailToPresentFullScreenContentWithError:(nonnull NSError *)error {
    NSLog(@"Ad did fail to present full screen content.");
}

/// Tells the delegate that the ad will present full screen content.
- (void)adWillPresentFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
    NSLog(@"Ad will present full screen content.");
}

/// Tells the delegate that the ad dismissed full screen content.
- (void)adDidDismissFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
    NSLog(@"Ad did dismiss full screen content.");
}

GADRewardedAd は使い捨てオブジェクトです。つまりリワード広告が再表示することはできません。おすすめの方法は、別のリワード広告を読み込むことです。 GADFullScreenContentDelegate の adDidDismissFullScreenContent: メソッド内それにより、前のリワード広告が読み込まれるとすぐに次のリワード広告の読み込みが開始されます。破棄しました。

広告を表示して報酬イベントを処理する

リワード広告をユーザーに表示する前に、報酬と引き換えにリワード広告のコンテンツを視聴するという明示的な選択リワード広告は常にオプトイン方式でなくてはなりません。

広告を表示する際は、GADUserDidEarnRewardHandler オブジェクトを指定する必要があります。報酬を処理することにしました

リワード広告を表示する最適な方法を次のコードに示します。

Swift

func show() {
  guard let rewardedAd = rewardedAd else {
    return print("Ad wasn't ready.")
  }

  // The UIViewController parameter is an optional.
  ad.present(fromRootViewController: nil) {
    let reward = ad.adReward
    print("Reward received with currency \(reward.amount), amount \(reward.amount.doubleValue)")
    // TODO: Reward the user.
  }
}

Objective-C

- (void)show {
  if (self.rewardedAd) {
    // The UIViewController parameter is nullable.
    [self.rewardedAd presentFromRootViewController:nil
                                  userDidEarnRewardHandler:^{
                                  GADAdReward *reward =
                                      self.rewardedAd.adReward;
                                  // TODO: Reward the user!
                                }];
  } else {
    NSLog(@"Ad wasn't ready");
  }
}

よくある質問

GADRewardedAd の特典の詳細を教えてもらえますか？

○（userDidEarnReward コールバックの前に報酬額が必要な場合）発生すると、GADRewardedAd には adReward プロパティを表示することで、広告の読み込み後に報酬の金額を確認できます。

初期化の呼び出しにタイムアウトはありますか？

10 秒後、Google Mobile Ads SDK が GADInitializationCompletionHandler を startWithCompletionHandler: メソッドが使用されます（メディエーションネットワークがまだ適用されていない場合も同様）。初期化が完了しています。

初期化コールバックを受け取ったときに、準備が完了していないメディエーションネットワークがある場合はどうなりますか？

広告の読み込みは GADInitializationCompletionHandler。メディエーションネットワークの準備ができていなくても Google Mobile Ads SDK はそのネットワークに広告をリクエストします。たとえば、タイムアウト後にメディエーションネットワークの初期化が終了しても、そのセッションで今後発生する広告リクエストの数をカウントします。

この期間中は、引き続きすべてのアダプタの初期化ステータスをポーリングできます。 GADMobileAds.initializationStatus を呼び出してアプリセッションを開始します。

特定のメディエーションネットワークの準備ができていない理由を調べるにはどうすればよいですか？

GADAdapterStatus オブジェクトの description プロパティでは、アダプターを使用する準備が整っていません。

userDidEarnRewardHandler 完了ハンドラは常に adDidDismissFullScreenContent: デリゲートメソッドの前に呼び出されますか？

Google 広告の場合、userDidEarnRewardHandler の呼び出しはすべて発生します adDidDismissFullScreenContent: より前にご確認ください。Google 広告を介して配信される広告については、メディエーションと第三者広告ネットワークコールバックの順序は SDK の実装によって決まります。使用できる広告ネットワーク SDK が報酬情報を含む単一のデリゲートメソッドを提供する、メディエーションアダプタ adDidDismissFullScreenContent: の前に userDidEarnRewardHandler を呼び出します。

GitHub の例

リワード広告の例: Swift | Objective-C

次のステップ

詳しくは、ユーザーのプライバシーについての説明をご覧ください。