Anúncios em banner

Selecione a plataforma: Android iOS Unity Flutter

Os anúncios de banner são retangulares e ocupam uma parte do layout do app. Eles permanecem na tela enquanto há interação com o aplicativo. Ficam fixados na parte de cima ou de baixo, ou aparecem no meio do conteúdo quando o usuário rola a tela. Os anúncios de banner podem ser atualizados automaticamente após determinado período. Consulte Visão geral dos anúncios de banner para mais informações.

Este guia mostra como começar a usar anúncios de banner adaptativo fixo, que maximizam a performance otimizando o tamanho do anúncio para cada dispositivo usando uma largura especificada.

Banner adaptativo fixo

Os anúncios de banner adaptativo fixo têm proporção fixa, em vez dos anúncios de tamanho fixo comuns. A proporção é semelhante ao padrão do setor de 320 x 50. Depois de especificar a largura total disponível, ele retorna um anúncio com a altura ideal para essa largura. A altura ideal não muda em solicitações do mesmo dispositivo, e as visualizações ao redor não precisam se mover quando o anúncio é atualizado.

Pré-requisitos

Sempre teste com anúncios de teste

Ao criar e testar seus apps, use anúncios de teste em vez de anúncios de produção ativos. Sua conta poderá ser suspensa se isso não for feito.

A maneira mais fácil de carregar anúncios de teste é usar nosso ID de bloco de anúncios de teste dedicado para banners do iOS:

ca-app-pub-3940256099942544/2435281174

Ele foi configurado especialmente para retornar anúncios de teste em todas as solicitações, e você pode usá-lo nos seus próprios apps durante a programação, o teste e a depuração. Substitua pelo ID do seu bloco de anúncios antes de publicar o app.

Para mais informações sobre como os anúncios de teste do SDK para dispositivos móveis funcionam, consulte Anúncios de teste.

Criar um GADBannerView

Os anúncios de banner são exibidos em objetos GADBannerView. Portanto, a primeira etapa para integrar anúncios de banner é incluir um GADBannerView na sua hierarquia de visualização. Isso geralmente é feito de forma programática ou pelo Interface Builder.

De forma programática

Um GADBannerView também pode ser instanciado diretamente. O exemplo a seguir cria um GADBannerView:

Swift

// Initialize the BannerView.
bannerView = BannerView()

bannerView.translatesAutoresizingMaskIntoConstraints = false
view.addSubview(bannerView)

// This example doesn't give width or height constraints, as the ad size gives the banner an
// intrinsic content size to size the view.
NSLayoutConstraint.activate([
  // Align the banner's bottom edge with the safe area's bottom edge
  bannerView.bottomAnchor.constraint(equalTo: view.safeAreaLayoutGuide.bottomAnchor),
  // Center the banner horizontally in the view
  bannerView.centerXAnchor.constraint(equalTo: view.centerXAnchor),
])
BannerSnippets.swift

SwiftUI

Para usar um BannerView, crie um UIViewRepresentable:

private struct BannerViewContainer: UIViewRepresentable {
  typealias UIViewType = BannerView
  let adSize: AdSize

  init(_ adSize: AdSize) {
    self.adSize = adSize
  }

  func makeUIView(context: Context) -> BannerView {
    let banner = BannerView(adSize: adSize)
    banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
    banner.load(Request())
    banner.delegate = context.coordinator
    return banner
  }

  func updateUIView(_ uiView: BannerView, context: Context) {}

  func makeCoordinator() -> BannerCoordinator {
    return BannerCoordinator(self)
  }
BannerContentView.swift

Adicione o UIViewRepresentable à hierarquia de visualização, especificando os valores height e width:

var body: some View {
  Spacer()
  // Request an anchored adaptive banner with a width of 375.
  let adSize = currentOrientationAnchoredAdaptiveBanner(width: 375)
  BannerViewContainer(adSize)
    .frame(width: adSize.size.width, height: adSize.size.height)
}
BannerContentView.swift

Objective-C

// Initialize the GADBannerView.
self.bannerView = [[GADBannerView alloc] init];

self.bannerView.translatesAutoresizingMaskIntoConstraints = NO;
[self.view addSubview:self.bannerView];

// This example doesn't give width or height constraints, as the ad size gives the banner an
// intrinsic content size to size the view.
[NSLayoutConstraint activateConstraints:@[
    // Align the banner's bottom edge with the safe area's bottom edge
    [self.bannerView.bottomAnchor constraintEqualToAnchor:self.view.safeAreaLayoutGuide.bottomAnchor],
    // Center the banner horizontally in the view
    [self.bannerView.centerXAnchor constraintEqualToAnchor:self.view.centerXAnchor],
]];
BannerSnippets.m

Interface Builder

É possível adicionar um GADBannerView a um storyboard ou arquivo xib. Ao usar esse método, adicione apenas restrições de posição no banner. Por exemplo, ao mostrar um banner adaptativo na parte de baixo da tela, defina a parte de baixo da visualização do banner igual à parte de cima do guia de layout inferior e defina a restrição centerX igual ao centerX da supervisualização.

O tamanho do anúncio do banner ainda é definido de forma programática:

Swift

// Request an anchored adaptive banner with a width of 375.
bannerView.adSize = currentOrientationAnchoredAdaptiveBanner(width: 375)
ViewController.swift

Objective-C

// Request an anchored adaptive banner with a width of 375.
self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(375);
ViewController.m

Carregar um anúncio

Depois que o GADBannerView estiver no lugar e as propriedades dele, como adUnitID, estiverem configuradas, é hora de carregar um anúncio. Para isso, chame loadRequest: em um objeto GADRequest:

Swift

bannerView.load(Request())
ViewController.swift

SwiftUI

banner.adUnitID = "ca-app-pub-3940256099942544/2435281174"
banner.load(Request())
BannerContentView.swift

Objective-C

[self.bannerView loadRequest:[GADRequest request]];
ViewController.m

Os objetos GADRequest representam uma única solicitação de anúncio e contêm propriedades para itens como informações de segmentação.

Atualizar um anúncio

Se você configurou o bloco de anúncios para ser atualizado, não é necessário solicitar outro anúncio quando ele não carrega. O SDK dos anúncios para dispositivos móveis do Google respeita qualquer taxa de atualização especificada na interface da AdMob. Se você não tiver ativado a atualização, faça uma nova solicitação. Para mais detalhes sobre a atualização de blocos de anúncios, como definir uma taxa de atualização, consulte Usar a atualização automática para anúncios de banner.

Eventos de anúncio

Com o uso de GADBannerViewDelegate, é possível detectar eventos de ciclo de vida, como quando um anúncio é fechado ou o usuário sai do app.

Registrar eventos de banner

Para registrar eventos de anúncios de banner, defina a propriedade delegate em GADBannerView como um objeto que implementa o protocolo GADBannerViewDelegate. Em geral, a classe que implementa anúncios de banner também atua como a classe delegada. Nesse caso, a propriedade delegate pode ser definida como self.

Swift

bannerView.delegate = self
ViewController.swift

SwiftUI

banner.delegate = context.coordinator
BannerContentView.swift

Objective-C

self.bannerView.delegate = self;
ViewController.m

Implementar eventos de banner

Cada um dos métodos em GADBannerViewDelegate é marcado como opcional, então você só precisa implementar os métodos que quiser. Este exemplo implementa cada método e registra uma mensagem no console:

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  print(#function)
}

func bannerView(_ bannerView: BannerView, didFailToReceiveAdWithError error: Error) {
  print(#function + ": " + error.localizedDescription)
}

func bannerViewDidRecordClick(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewDidRecordImpression(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewWillPresentScreen(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewWillDismissScreen(_ bannerView: BannerView) {
  print(#function)
}

func bannerViewDidDismissScreen(_ bannerView: BannerView) {
  print(#function)
}
ViewController.swift

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidReceiveAd");
}

- (void)bannerView:(GADBannerView *)bannerView didFailToReceiveAdWithError:(NSError *)error {
  NSLog(@"bannerView:didFailToReceiveAdWithError: %@", [error localizedDescription]);
}

- (void)bannerViewDidRecordImpression:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidRecordImpression");
}

- (void)bannerViewWillPresentScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewWillPresentScreen");
}

- (void)bannerViewWillDismissScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewWillDismissScreen");
}

- (void)bannerViewDidDismissScreen:(GADBannerView *)bannerView {
  NSLog(@"bannerViewDidDismissScreen");
}
ViewController.m

Consulte o exemplo de delegado de anúncio para uma implementação de métodos delegados de banner no app de demonstração da API iOS.

Swift Objective-C

Casos de uso

Confira alguns exemplos de casos de uso para esses métodos de evento de anúncio.

Adicionar um banner à hierarquia de visualização assim que um anúncio for recebido

Talvez seja necessário atrasar a adição de um GADBannerView à hierarquia de visualização até depois que um anúncio for recebido. Para isso, detecte o evento bannerViewDidReceiveAd::

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  // Add banner to view and add constraints.
  addBannerViewToView(bannerView)
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  // Add bannerView to view and add constraints as above.
  [self addBannerViewToView:self.bannerView];
}

Animar um anúncio de banner

Você também pode usar o evento bannerViewDidReceiveAd: para animar um anúncio de banner assim que ele for retornado, conforme mostrado no exemplo a seguir:

Swift

func bannerViewDidReceiveAd(_ bannerView: BannerView) {
  bannerView.alpha = 0
  UIView.animate(withDuration: 1, animations: {
    bannerView.alpha = 1
  })
}

Objective-C

- (void)bannerViewDidReceiveAd:(GADBannerView *)bannerView {
  bannerView.alpha = 0;
  [UIView animateWithDuration:1.0 animations:^{
    bannerView.alpha = 1;
  }];
}

Pausar e retomar o app

O protocolo GADBannerViewDelegate tem métodos para notificar você sobre eventos, como quando um clique faz com que uma sobreposição seja apresentada ou dispensada. Se você quiser rastrear se esses eventos foram causados por anúncios, registre-se nesses métodos GADBannerViewDelegate.

Para detectar todos os tipos de apresentações de sobreposição ou invocações de navegador externo, não apenas aquelas que vêm de cliques em anúncios, é melhor que seu app fique atento aos métodos equivalentes em UIViewController ou UIApplication. Confira uma tabela mostrando os métodos equivalentes do iOS que são invocados ao mesmo tempo que os métodos GADBannerViewDelegate:

Método GADBannerViewDelegate Método do iOS
bannerViewWillPresentScreen: viewWillDisappear: do UIViewController
bannerViewWillDismissScreen: viewWillAppear: do UIViewController
bannerViewDidDismissScreen: viewDidAppear: do UIViewController

Outros recursos

Exemplos no GitHub

Próximas etapas

Banners recolhíveis

Os anúncios de banner recolhíveis são apresentados inicialmente como uma sobreposição maior, com um botão para recolher o anúncio para um tamanho menor. Considere usar esse recurso para otimizar ainda mais sua performance. Consulte anúncios de banner recolhíveis para mais detalhes.

Banners adaptativos inline

Os banners adaptativos in-line são maiores e mais altos do que os fixos. Eles têm altura variável e podem ser tão altos quanto a tela do dispositivo. Os banners adaptativos inline são recomendados em vez dos anúncios de banner adaptativo fixos para apps que colocam anúncios de banner em conteúdo rolável. Consulte banners adaptáveis inline para mais detalhes.

Confira outros temas