如需讨论我们的产品并提供反馈，请加入 Google 广告和效果衡量社区服务器中的官方 AdMob Discord 频道。

此页面由 Cloud Translation API 翻译。

开屏广告

请选择平台： Android iOS Unity Flutter

本指南适用于植入开屏广告的发布商。

开屏广告是一种特殊的广告格式，适合希望通过应用加载屏幕创收的发布商。用户可以随时关闭开屏广告。开屏广告可以在用户将您的应用切换为在前台运行时展示。

开屏广告会自动在一个较小的区域内展示您的品牌信息，让用户知道他们是在您的应用中。以下是一个开屏广告示例：

概括来讲，植入开屏广告需要执行的步骤如下：

创建一个管理器类，用于先加载广告，以备需要展示时使用。
在应用进入前台事件期间展示广告。
处理展示回调。

前提条件

按照入门指南中的设置说明操作。
了解如何将设备配置为测试设备。

务必用测试广告进行测试

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

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

ca-app-pub-3940256099942544/5575463023

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

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

实现管理器类

您的广告应该要快速展示，因此最好先加载广告，以备需要展示时使用。这样一来，用户进入您的应用后，广告便可以立即展示。实现管理器类，即可在您需要展示广告之前发出广告请求。

创建一个名为 AppOpenAdManager 的新单例类：

Swift

class AppOpenAdManager: NSObject {
  /// The app open ad.
  var appOpenAd: AppOpenAd?
  /// Maintains a reference to the delegate.
  weak var appOpenAdManagerDelegate: AppOpenAdManagerDelegate?
  /// Keeps track of if an app open ad is loading.
  var isLoadingAd = false
  /// Keeps track of if an app open ad is showing.
  var isShowingAd = false
  /// Keeps track of the time when an app open ad was loaded to discard expired ad.
  var loadTime: Date?
  /// For more interval details, see https://support.google.com/admob/answer/9341964
  let timeoutInterval: TimeInterval = 4 * 3_600

  static let shared = AppOpenAdManager()AppOpenAdManager.swift

Objective-C

@interface AppOpenAdManager ()

/// The app open ad.
@property(nonatomic, strong, nullable) GADAppOpenAd *appOpenAd;
/// Keeps track of if an app open ad is loading.
@property(nonatomic, assign) BOOL isLoadingAd;
/// Keeps track of if an app open ad is showing.
@property(nonatomic, assign) BOOL isShowingAd;
/// Keeps track of the time when an app open ad was loaded to discard expired ad.
@property(nonatomic, strong, nullable) NSDate *loadTime;

@end

/// For more interval details, see https://support.google.com/admob/answer/9341964
static const NSInteger kTimeoutInterval = 4;

@implementation AppOpenAdManager

+ (nonnull AppOpenAdManager *)sharedInstance {
  static AppOpenAdManager *instance = nil;
  static dispatch_once_t onceToken;
  dispatch_once(&onceToken, ^{
    instance = [[AppOpenAdManager alloc] init];
  });
  return instance;
}AppOpenAdManager.m

并实现其 AppOpenAdManagerDelegate 协议：

Swift

protocol AppOpenAdManagerDelegate: AnyObject {
  /// Method to be invoked when an app open ad life cycle is complete (i.e. dismissed or fails to
  /// show).
  func appOpenAdManagerAdDidComplete(_ appOpenAdManager: AppOpenAdManager)
}AppOpenAdManager.swift

Objective-C

@protocol AppOpenAdManagerDelegate <NSObject>
/// Method to be invoked when an app open ad life cycle is complete (i.e. dismissed or fails to
/// show).
- (void)adDidComplete;
@endAppOpenAdManager.h

加载广告

下一步是加载开屏广告：

Swift

func loadAd() async {
  // Do not load ad if there is an unused ad or one is already loading.
  if isLoadingAd || isAdAvailable() {
    return
  }
  isLoadingAd = true

  do {
    appOpenAd = try await AppOpenAd.load(
      with: "ca-app-pub-3940256099942544/5575463023", request: Request())
    appOpenAd?.fullScreenContentDelegate = self
    loadTime = Date()
  } catch {
    print("App open ad failed to load with error: \(error.localizedDescription)")
    appOpenAd = nil
    loadTime = nil
  }
  isLoadingAd = false
}AppOpenAdManager.swift

Objective-C

- (void)loadAd {
  // Do not load ad if there is an unused ad or one is already loading.
  if ([self isAdAvailable] || self.isLoadingAd) {
    return;
  }
  self.isLoadingAd = YES;

  [GADAppOpenAd loadWithAdUnitID:@"ca-app-pub-3940256099942544/5575463023"
                         request:[GADRequest request]
               completionHandler:^(GADAppOpenAd * _Nullable appOpenAd, NSError * _Nullable error) {
    self.isLoadingAd = NO;
    if (error) {
      NSLog(@"App open ad failed to load with error: %@", error);
      self.appOpenAd = nil;
      self.loadTime = nil;
      return;
    }
    self.appOpenAd = appOpenAd;
    self.appOpenAd.fullScreenContentDelegate = self;
    self.loadTime = [NSDate date];
  }];
}AppOpenAdManager.m

展示广告

下一步是展示开屏广告。如果没有可展示的广告，请尝试加载新广告。

Swift

func showAdIfAvailable() {
  // If the app open ad is already showing, do not show the ad again.
  if isShowingAd {
    return print("App open ad is already showing.")
  }

  // If the app open ad is not available yet but is supposed to show, load
  // a new ad.
  if !isAdAvailable() {
    print("App open ad is not ready yet.")
    // The app open ad is considered to be complete in this example.
    appOpenAdManagerDelegate?.appOpenAdManagerAdDidComplete(self)
    // Load a new ad.
    return
  }

  if let appOpenAd {
    appOpenAd.present(from: nil)
    isShowingAd = true
  }
}AppOpenAdManager.swift

Objective-C

- (void)showAdIfAvailable {
  // If the app open ad is already showing, do not show the ad again.
  if (self.isShowingAd) {
    NSLog(@"App open ad is already showing.");
    return;
  }

  // If the app open ad is not available yet but is supposed to show, load
  // a new ad.
  if (![self isAdAvailable]) {
    NSLog(@"App open ad is not ready yet.");
    // The app open ad is considered to be complete in this example.
    [self adDidComplete];
    // Load a new ad.
    return;
  }

  [self.appOpenAd presentFromRootViewController:nil];
  self.isShowingAd = YES;
}AppOpenAdManager.m

在应用进入前台事件期间展示广告

当应用变为有效状态时，调用 showAdIfAvailable() 以显示广告（如果有），或加载新广告。

Swift

func applicationDidBecomeActive(_ application: UIApplication) {
  // Show the app open ad when the app is foregrounded.
  AppOpenAdManager.shared.showAdIfAvailable()
}AppDelegate.swift

Objective-C

- (void) applicationDidBecomeActive:(UIApplication *)application {
  // Show the app open ad when the app is foregrounded.
  [AppOpenAdManager.sharedInstance showAdIfAvailable];
}AppDelegate.m

处理展示回调

如需接收有关展示事件的通知，您必须将 GADFullScreenContentDelegate 分配给返回的广告的 fullScreenContentDelegate 属性：

Swift

appOpenAd?.fullScreenContentDelegate = selfAppOpenAdManager.swift

Objective-C

self.appOpenAd.fullScreenContentDelegate = self;AppOpenAdManager.m

具体而言，您需要在第一个开屏广告展示完毕时请求下一个开屏广告。以下代码展示了如何在 AppOpenAdManager 文件中实现该协议：

Swift

func adDidRecordImpression(_ ad: FullScreenPresentingAd) {
  print("App open ad recorded an impression.")
}

func adDidRecordClick(_ ad: FullScreenPresentingAd) {
  print("App open ad recorded a click.")
}

func adWillDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("App open ad will be dismissed.")
}

func adWillPresentFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("App open ad will be presented.")
}

func adDidDismissFullScreenContent(_ ad: FullScreenPresentingAd) {
  print("App open ad was dismissed.")
  appOpenAd = nil
  isShowingAd = false
  appOpenAdManagerDelegate?.appOpenAdManagerAdDidComplete(self)
  Task {
    await loadAd()
  }
}

func ad(
  _ ad: FullScreenPresentingAd,
  didFailToPresentFullScreenContentWithError error: Error
) {
  print("App open ad failed to present with error: \(error.localizedDescription)")
  appOpenAd = nil
  isShowingAd = false
  appOpenAdManagerDelegate?.appOpenAdManagerAdDidComplete(self)
  Task {
    await loadAd()
  }
}AppOpenAdManager.swift

Objective-C

- (void)adDidRecordImpression:(nonnull id<GADFullScreenPresentingAd>)ad {
  NSLog(@"App open ad recorded an impression.");
}

- (void)adDidRecordClick:(nonnull id<GADFullScreenPresentingAd>)ad {
  NSLog(@"App open ad recorded a click.");
}

- (void)adWillPresentFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
  NSLog(@"App open ad will be presented.");
}

- (void)adWillDismissFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
  NSLog(@"App open ad will be dismissed.");
}

- (void)adDidDismissFullScreenContent:(nonnull id<GADFullScreenPresentingAd>)ad {
  NSLog(@"App open ad was dismissed.");
  self.appOpenAd = nil;
  self.isShowingAd = NO;
  [self adDidComplete];
  [self loadAd];
}

- (void)ad:(nonnull id<GADFullScreenPresentingAd>)ad
    didFailToPresentFullScreenContentWithError:(nonnull NSError *)error {
  NSLog(@"App open ad failed to present with error: %@", error.localizedDescription);
  self.appOpenAd = nil;
  self.isShowingAd = NO;
  [self adDidComplete];
  [self loadAd];
}AppOpenAdManager.m

考虑广告有效期

为确保您不会展示过期的广告，您可以在应用代理中添加一个方法，该方法会检查您的广告引用加载后经过的时间。

在 AppOpenAdManager 中，添加一个名为 loadTime 的 Date 属性，并在广告加载时设置该属性。接下来，您可以添加一个方法，该方法会在广告加载后经过的时间少于一定的小时数时返回 true。请务必先检查广告引用的有效性，然后再尝试展示广告。

Swift

private func wasLoadTimeLessThanNHoursAgo(timeoutInterval: TimeInterval) -> Bool {
  // Check if ad was loaded more than n hours ago.
  if let loadTime = loadTime {
    return Date().timeIntervalSince(loadTime) < timeoutInterval
  }
  return false
}

private func isAdAvailable() -> Bool {
  // Check if ad exists and can be shown.
  return appOpenAd != nil && wasLoadTimeLessThanNHoursAgo(timeoutInterval: timeoutInterval)
}AppOpenAdManager.swift

Objective-C

- (BOOL)wasLoadTimeLessThanNHoursAgo:(int)n {
  // Check if ad was loaded more than n hours ago.
  NSDate *now = [NSDate date];
  NSTimeInterval timeIntervalBetweenNowAndLoadTime = [now timeIntervalSinceDate:self.loadTime];
  double secondsPerHour = 3600.0;
  double intervalInHours = timeIntervalBetweenNowAndLoadTime / secondsPerHour;
  return intervalInHours < n;
}

- (BOOL)isAdAvailable {
  // Check if ad exists and can be shown.
  return _appOpenAd && [self wasLoadTimeLessThanNHoursAgo:kTimeoutInterval];
}AppOpenAdManager.m

冷启动和加载屏幕

本文档假定您仅在以下情况下展示开屏广告：用户将在内存中挂起的应用切换为在前台运行。用户启动您的应用，但该应用之前未在内存中挂起，这种情况就称为“冷启动”。

例如，用户首次打开您的应用便属于冷启动。对于冷启动，您没有之前已加载的开屏广告可供立即展示。请求广告和收到相应广告之间的延迟会导致出现以下情况：用户能够暂时使用您的应用，然后突然看到一条无关广告。应避免出现这种情况，因为这会导致用户体验不佳。

在冷启动时使用开屏广告的首选方法是，使用加载屏幕来加载游戏或应用素材资源，并且仅在加载屏幕展示广告。如果您的应用已加载完毕，并且用户已经看到应用的主要内容，则不要展示广告。

最佳做法

借助 Google 打造的开屏广告，您可以通过应用的加载屏幕创收。不过，还请务必考虑一些最佳实践，以便让用户喜欢使用您的应用。请务必遵循以下做法：

等待用户使用几次您的应用后，再展示第一个开屏广告。
利用用户等待应用加载的那段时间，展示开屏广告。
如果有加载屏幕位于开屏广告之下，并且加载屏幕在用户关闭广告之前已加载完毕，您可能需要通过 adDidDismissFullScreenContent 方法关闭加载屏幕。

GitHub 上的完整示例

Swift Objective-C

后续步骤

详细了解用户隐私权。

开屏广告 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

前提条件

务必用测试广告进行测试

实现管理器类

Swift

Objective-C

Swift

Objective-C

加载广告

Swift

Objective-C

展示广告

Swift

Objective-C

在应用进入前台事件期间展示广告

Swift

Objective-C

处理展示回调

Swift

Objective-C

Swift

Objective-C

考虑广告有效期

Swift

Objective-C

冷启动和加载屏幕

最佳做法

GitHub 上的完整示例

后续步骤

开屏广告