激励广告

所谓激励广告，指的是用户可以选择与之互动来换取应用内奖励的一种广告。本指南介绍了如何将 AdMob 激励广告植入到 iOS 应用中。欢迎查看客户成功案例：案例研究 1、案例研究 2。

前提条件

Google 移动广告 SDK 8.0.0 或更高版本
按照入门指南导入 Google 移动广告 SDK。

务必用测试广告进行测试

在构建和测试应用时，请确保使用的是测试广告，而不是实际投放的广告。否则，可能会导致您的帐号被暂停。

对于 iOS 激励广告，加载测试广告最简便的方法就是使用下面的专用测试广告单元 ID：

ca-app-pub-3940256099942544/1712485313

该测试广告单元 ID 已经过专门配置，可为每个请求返回测试广告，您可以在自己应用的编码、测试和调试过程中随意使用该测试广告单元 ID。只需确保您会在发布应用前用自己的广告单元 ID 替换该测试广告单元 ID 即可。

如需详细了解移动广告 SDK 的测试广告如何运作，请参阅测试广告。

植入

植入激励广告的主要步骤如下所示：

加载广告。
注册回调。
展示广告并处理奖励事件。

加载广告

广告加载是通过针对 GADRewardedAd 类使用静态 loadWithAdUnitID:request:completionHandler: 方法完成的。load 方法需要使用您的广告单元 ID、GADRequest 对象以及在广告加载成功或失败时调用的完成处理程序。已加载的 GADRewardedAd 对象以完成处理程序中的参数的形式提供。以下示例展示了如何在 ViewController 类中加载 GADRewardedAd：

Objective-C

@import GoogleMobileAds;
@import UIKit;

@interface ViewController ()

@property(nonatomic, strong) GADRewardedAd *rewardedAd;

@end

@implementation ViewController
- (void)loadRewardedAd {
  GADRequest *request = [GADRequest 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.");
      }];
}

注册回调

要接收有关展示事件的通知，您必须实现 GADFullScreenContentDelegate 协议并将其分配给已返回广告的 fullScreenContentDelegate 属性。GADFullScreenContentDelegate 协议会在广告成功展示或展示失败，以及用户关闭广告时处理回调。以下代码演示了如何实现此协议并将其分配给广告：

Objective-C

@interface ViewController ()<GADFullScreenContentDelegate>

@property(nonatomic, strong) GADRewardedAd *rewardedAd;

@end

@implementation ViewController
- (void)loadRewardedAd {
  GADRequest *request = [GADRequest 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 presented full screen content.
- (void)adDidPresentFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
    NSLog(@"Ad did 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 对象，用于处理用户奖励。

以下代码演示了展示激励广告的最佳方法：

Objective-C

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

常见问题解答

我可以获取 GADRewardedAd 的详细奖励信息吗？

可以，如果您需要在 userDidEarnReward 回调触发之前获取奖励金额信息，可以查看 GADRewardedAd 的 adReward 属性，在广告加载后验证奖励金额。

初始化调用是否会超时？

10 秒后，即使中介广告联盟仍未完成初始化，Google 移动广告 SDK 还是会调用提供给 startWithCompletionHandler: 方法的 GADInitializationCompletionHandler。

在获得初始化回调时，如果某些中介广告联盟还没有准备好，该怎么办？

最佳做法是在 GADInitializationCompletionHandler 中加载广告。即使中介广告联盟尚未就绪，Google 移动广告 SDK 仍会向该广告联盟请求广告。因此，如果中介广告联盟在超时后完成初始化，它仍然可以在该会话中为将来的广告请求提供服务。

您可以通过调用 GADMobileAds.initializationStatus 继续在整个应用会话中轮询所有适配器的初始化状态。

如何找出特定中介广告联盟未做好准备的原因？

GADAdapterStatus 对象的 description 属性描述了适配器未准备好为广告请求提供服务的原因。