从 iOS 13 开始,应用可以在 iPad 上支持多个窗口,这意味着用户可以同时与应用界面的多个并发副本进行交互。每个窗口都可以创建不同尺寸,并且可以随时调整大小,这会影响广告的加载和展示方式。
本指南旨在向您展示在 iPad 多窗口场景中正确呈现广告的最佳实践。
前提条件
- Google 移动广告 SDK 7.53.0 或更高版本
- 在项目中启用场景支持
- 实现至少一种广告格式
在广告请求中设置场景
为了接收适合特定窗口的广告,您需要将视图的 windowScene
传递给广告请求。Google 移动广告 SDK 会返回尺寸适合该场景的广告。
Swift
func loadInterstitial() { let request = GADRequest() request.scene = view.window?.windowScene GADInterstitialAd.load(withAdUnitID: "[AD_UNIT_ID]", request: request) { ad, error in } }
Objective-C
- (void)loadInterstitial { GADRequest *request = [GADRequest request]; request.scene = self.view.window.windowScene; [GADInterstitialAd loadWithAdUnitID:@"[AD_UNIT_ID]" request:request completionHandler:^(GADInterstitialAd *ad, NSError *error) {}]; }
在测试模式下,如果您的多场景应用请求广告而不传递场景,则广告请求将失败并显示以下错误:
<Google> Invalid Request. The GADRequest scene property should be set for
applications that support multi-scene. Treating the unset property as an error
while in test mode.
在生产模式下,广告请求会进行填充,但如果广告在非全屏窗口中展示,则将无法展示广告。在这种情况下,错误消息为:
<Google> Ad cannot be presented. The full screen ad content size exceeds the current window size.
在 viewDidAppear 中构建广告请求:
在多窗口模式下,需要有一个用于发送广告请求的窗口场景。由于视图尚未添加到 viewDidLoad:
中的窗口,因此您应在当时设置窗口场景的 viewDidAppear:
中构建广告请求。
请注意,在应用的生命周期内,可以多次调用 viewDidAppear:
。我们建议您将广告请求初始化代码封装在一个标记中,以表明相应初始化代码是否已完成。
Swift
override func viewDidAppear(_ animated: Bool) { super.viewDidAppear(animated) if !requestInitialized { loadInterstitial() requestInitialized = true } }
Objective-C
- (void)viewDidAppear:(BOOL)animated { [super viewDidAppear:animated]; if (!_requestInitialized) { [self loadInterstitial]; _requestInitialized = YES; } }
处理大小调整
用户可以随时拖动场景,在发出广告请求后更改窗口大小。调整大小时,您可以请求新的广告。
以下示例代码使用 viewWillTransitionToSize:withTransitionCoordinator:
在根视图控制器的窗口旋转或调整大小时收到通知,但您也可以监听 windowScene:didUpdateCoordinateSpace:interfaceOrientation:traitCollection:
,了解窗口场景特定变化。
插页式广告和激励广告
Google 移动广告 SDK 提供了 canPresentFromViewController:error:
方法来确定插页式广告或激励广告是否有效,让您能够检查是否需要在每次窗口大小发生变化时刷新全屏广告。
Swift
override func viewWillTransition(to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator) { super.viewWillTransition(to: size, with: coordinator) coordinator.animate(alongsideTransition: nil) { [self] context in do { try interstitial?.canPresent(fromRootViewController: self) } catch { loadInterstitial() } } }
Objective-C
- (void)viewWillTransitionToSize:(CGSize)size withTransitionCoordinator:(id)coordinator { [super viewWillTransitionToSize:size withTransitionCoordinator:coordinator]; [coordinator animateAlongsideTransition:nil completion:^(id _Nonnull context) { if (![self.interstitial canPresentFromRootViewController:self error:nil]) { [self loadInterstitial]; } }]; }
横幅
您可以像处理窗口旋转一样处理窗口大小调整。您的应用应负责确保横幅广告适合新的窗口大小。
下例就创建了一个采用新窗口宽度的新自适应横幅广告:
Swift
override func viewWillTransition(to size: CGSize, with coordinator: UIViewControllerTransitionCoordinator) { super.viewWillTransition(to: size, with: coordinator) coordinator.animate(alongsideTransition: nil) { [self] context in loadBanner() } } func loadBanner() { let bannerWidth = view.frame.size.width bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(bannerWidth) let request = GADRequest() request.scene = view.window?.windowScene bannerView.load(request) }
Objective-C
- (void)viewWillTransitionToSize:(CGSize)size withTransitionCoordinator:(id)coordinator { [super viewWillTransitionToSize:size withTransitionCoordinator:coordinator]; [coordinator animateAlongsideTransition:nil completion:^(id _Nonnull context) { [self loadBannerAd]; }]; } - (void)loadBannerAd { CGFloat bannerWidth = self.view.frame.size.width; self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(bannerWidth); GADRequest *request = [GADRequest request]; request.scene = self.view.window.windowScene; [self.bannerView loadRequest:request]; }
原生广告
您可以控制原生广告的呈现,并负责确保原生广告在调整过的视图内呈现(与应用内容的其余部分类似)。
已知问题
目前,仅在纵向模式下支持多窗口广告和分屏广告。 在横屏模式下请求广告时,您会收到以下日志消息。
<Google> Ad cannot be presented. The full screen ad content size exceeds the
current window size.