No iOS 13 e versões mais recentes, os aplicativos oferecem suporte a várias janelas no iPad, o que significa que os usuários podem interagir com várias cópias simultâneas da interface de um app. Cada janela pode ser criada em tamanhos diferentes e redimensionada a qualquer momento, o que afeta a forma como os anúncios são carregados e apresentados.
Este guia mostra as práticas recomendadas para renderizar anúncios corretamente em um cenário de várias janelas no iPad.
Pré-requisitos
- SDK dos anúncios para dispositivos móveis do Google 7.53.0 ou mais recente
- Ativar o suporte de cena no seu projeto
- Implemente pelo menos um formato de anúncio.
Contextualizar em uma solicitação de anúncio
Para receber um anúncio que se encaixe em uma janela específica, você transmite o windowScene
da visualização à solicitação de anúncio. O SDK dos anúncios para dispositivos móveis do Google retorna um anúncio com um tamanho válido para o cenário.
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) {}]; }
No modo de teste, as solicitações de anúncios vão falhar com o seguinte erro se o app de várias cenas solicitar um anúncio sem transmitir uma cena:
<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.
No modo de produção, a solicitação de anúncio é preenchida, mas a apresentação do anúncio vai falhar se ele for mostrado em uma janela que não seja de tela cheia. A mensagem de erro nesse caso é:
<Google> Ad cannot be presented. The full screen ad content size exceeds the current window size.
Crie a solicitação de anúncio em view impressõesID:
O caso de várias janelas apresenta um requisito de ter uma cena de janela para
enviar solicitações de anúncios. Como uma visualização ainda não foi adicionada a uma janela em
viewDidLoad:
, crie solicitações de anúncios em viewDidAppear:
em que a cena da janela é definida por esse ponto.
Observe que viewDidAppear:
pode ser chamado mais de uma vez durante o ciclo de vida
de um app. Recomendamos que você coloque o código de inicialização da solicitação de anúncio em uma sinalização que indique se isso já foi feito.
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; } }
Processar redimensionamento
Os usuários podem arrastar as cenas a qualquer momento, mudando o tamanho da janela após uma solicitação
de anúncio. Cabe a você solicitar um novo anúncio quando o redimensionamento ocorre.
O exemplo de código abaixo usa
viewWillTransitionToSize:withTransitionCoordinator:
para receber uma notificação quando a janela do controlador de visualização raiz for girada ou redimensionada, mas
você também pode detectar
windowScene:didUpdateCoordinateSpace:interfaceOrientation:traitCollection:
para mudanças específicas da cena da janela.
Anúncio premiado e intersticial
O SDK dos anúncios para dispositivos móveis do Google fornece o método canPresentFromViewController:error:
para determinar se um intersticial ou um anúncio premiado é válido ou não, permitindo verificar se algum anúncio de tela cheia precisa ser atualizado sempre que o tamanho da janela muda.
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]; } }]; }
Banner
É possível processar o redimensionamento de janela da mesma forma que é feito para rotação de janelas. Seu app é responsável por garantir que o anúncio de banner se ajuste ao novo tamanho da janela.
O exemplo abaixo cria um novo banner adaptativo com a nova largura da janela:
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]; }
Anúncio nativo
Você controla a renderização de anúncios nativos e é responsável por garantir que eles sejam renderizados dentro de uma visualização redimensionada, semelhante ao restante do conteúdo do app.
Problemas conhecidos
No momento, os anúncios de várias janelas e tela dividida são compatíveis apenas com o modo retrato. Você receberá a seguinte mensagem de registro ao solicitar um anúncio no modo paisagem.
<Google> Ad cannot be presented. The full screen ad content size exceeds the
current window size.