Anúncios de banner recolhíveis

Os anúncios de banner que podem ser recolhidos são exibidos inicialmente como um banner maior com um botão para recolhê-las ao tamanho do banner solicitado originalmente. O objetivo dos anúncios em banner colapsáveis é melhorar a performance dos anúncios fixos de tamanho menor. Este guia mostra como ativar o banner que pode ser recolhido para posições de banner.

Pré-requisitos

• Leia o guia de primeiros passos com anúncios de banner.

Implementação

Verifique se a visualização do banner está definida com o tamanho que você quer mostrar aos usuários no estado de banner normal (recolhido). Inclua um parâmetro extras na solicitação do anúncio com collapsible como chave e a posição do anúncio como valor.

O posicionamento que pode ser recolhido define como a região expandida é fixada no banner anúncio.

Valor Placement	Comportamento	Caso de uso pretendido
top	A parte superior do anúncio expandido será alinhada à parte superior do anúncio recolhido.	O anúncio é posicionado na parte superior da tela.
bottom	A parte inferior do anúncio expandido se alinha à parte inferior do anúncio recolhido. anúncio.	O anúncio é colocado na parte de baixo da tela.

Se o anúncio carregado for um banner que pode ser recolhido, ele mostrará o banner que pode ser recolhido sobreposição imediatamente após ser colocado na hierarquia de visualização.

Swift

func loadBannerAd() {
   bannerView.adUnitID = "ca-app-pub-3940256099942544/8388050270"
   bannerView.rootViewController = self
   let viewWidth = FRAME_WIDTH
   bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)

   let request = GADRequest()

   // Create an extra parameter that aligns the bottom of the expanded ad to
   // the bottom of the bannerView.
   let extras = GADExtras()
   extras.additionalParameters = ["collapsible" : "bottom"]
   request.register(extras)

   bannerView.load(request)
 }

Objective-C

- (void)loadBannerAd {
  self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/8388050270";
  CGFloat viewWidth = FRAME_WIDTH;
  self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);

  GADRequest *request = [GADRequest request];

  // Create an extra parameter that aligns the bottom of the expanded ad to the
  // bottom of the bannerView.
  GADExtras *extras = [[GADExtras alloc] init];
  extras.additionalParameters = @{@"collapsible" : @"bottom"};
  [request registerAdNetworkExtras:extras];

  [self.bannerView loadRequest:request];
}

Comportamento de atualização dos anúncios

Para apps que configuram a atualização automática de anúncios de banner na interface da Web da AdMob, quando um anúncio de banner recolhível é solicitado para um espaço de banner, as atualizações subsequentes do anúncio não solicitam anúncios de banner recolhível. Isso ocorre porque a exibição de um banner que pode ser recolhido em cada atualizar pode ter um impacto negativo na experiência do usuário.

Se você quiser carregar outro anúncio de banner recolhível mais tarde na sessão, carregue um anúncio manualmente com uma solicitação que contenha o parâmetro collapsible.

Verificar se um anúncio carregado pode ser recolhido

Os anúncios de banner não recolhíveis podem retornar para solicitações de banner recoletivo para maximizar a performance. Chame isCollapsible para verificar se o último banner carregado pode ser recolhido. Se a solicitação não for carregada e o banner anterior for colapsável, a API vai retornar "true".

Swift

func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
  print("The last loaded banner is \(bannerView.isCollapsible ? "" : "not") collapsible.")
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  NSLog(@"The last loaded banner is %@collapsible.", (bannerView.isCollapsible ? @"" : @"not "));
}

Mediação

Os anúncios de banner que podem ser recolhidos estão disponíveis apenas para a demanda do Google na versão Beta período Os anúncios veiculados pela mediação aparecem como anúncios de banner normais e não colapsáveis.