Esta página foi traduzida pela API Cloud Translation.

Anúncios de banner

Os anúncios de banner são retangulares e ocupam uma parte do layout de um app. Eles permanecem na tela enquanto os usuários interagem com o app, seja ancorado na parte superior ou inferior da tela ou inline com o conteúdo conforme o usuário rola a tela. Banner os anúncios podem ser atualizados automaticamente após um determinado período. Consulte a Visão geral dos anúncios de banner. para mais informações.

Este guia mostra como começar a usar o banner adaptativo fixo anúncios, que maximiza o desempenho otimizando o tamanho do anúncio para cada dispositivo usando uma largura que você especificar.

Banner adaptativo fixo

Os anúncios de banner adaptativo fixo são anúncios de proporção fixa, e não os de tamanho fixo. A proporção é semelhante ao padrão do setor de 320 x 50. Uma vez você especificar a largura total disponível, ele retornará um anúncio com a altura para essa largura. A altura ideal não muda entre as solicitações de no mesmo dispositivo, e as visualizações ao redor não precisam se mover quando o anúncio é atualizado.

Pré-requisitos

Leia o Guia explicativo.

Sempre faça testes 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 iOS banners: ca-app-pub-3940256099942544/2435281174

Ele foi configurado especialmente para retornar anúncios de teste para todas as solicitações, e você sem custos para usá-lo nos seus próprios apps durante a programação, o teste e a depuração. Apenas faça lembre-se de substituí-lo pelo seu próprio ID do bloco de anúncios antes de publicar o aplicativo.

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

Criar um GADBannerView

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

De forma programática

Um GADBannerView também pode ser instanciado diretamente. Confira um exemplo de como criar um GADBannerView. alinhado à parte inferior central da área segura da tela:

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController {

  var bannerView: GADBannerView!

  override func viewDidLoad() {
    super.viewDidLoad()
    
    let viewWidth = view.frame.inset(by: view.safeAreaInsets).width

    // Here the current interface orientation is used. Use
    // GADLandscapeAnchoredAdaptiveBannerAdSizeWithWidth or
    // GADPortraitAnchoredAdaptiveBannerAdSizeWithWidth if you prefer to load an ad of a
    // particular orientation,
    let adaptiveSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)
    bannerView = GADBannerView(adSize: adaptiveSize)

    addBannerViewToView(bannerView)
  }

  func addBannerViewToView(_ bannerView: GADBannerView) {
    bannerView.translatesAutoresizingMaskIntoConstraints = false
    view.addSubview(bannerView)
    view.addConstraints(
      [NSLayoutConstraint(item: bannerView,
                          attribute: .bottom,
                          relatedBy: .equal,
                          toItem: view.safeAreaLayoutGuide,
                          attribute: .bottom,
                          multiplier: 1,
                          constant: 0),
       NSLayoutConstraint(item: bannerView,
                          attribute: .centerX,
                          relatedBy: .equal,
                          toItem: view,
                          attribute: .centerX,
                          multiplier: 1,
                          constant: 0)
      ])
   }
   
}

Objective-C

@import GoogleMobileAds;

@interface ViewController ()

@property(nonatomic, strong) GADBannerView *bannerView;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  
  // Here safe area is taken into account, hence the view frame is used after the
  // view has been laid out.
  CGRect frame = UIEdgeInsetsInsetRect(self.view.frame, self.view.safeAreaInsets);
  CGFloat viewWidth = frame.size.width;

  // Here the current interface orientation is used. If the ad is being preloaded
  // for a future orientation change or different orientation, the function for the
  // relevant orientation should be used.
  GADAdSize adaptiveSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);
  // In this case, we instantiate the banner with desired ad size.
  self.bannerView = [[GADBannerView alloc] initWithAdSize:adaptiveSize];

  [self addBannerViewToView:self.bannerView];
}

- (void)addBannerViewToView:(UIView *)bannerView {
  bannerView.translatesAutoresizingMaskIntoConstraints = NO;
  [self.view addSubview:bannerView];
  [self.view addConstraints:@[
    [NSLayoutConstraint constraintWithItem:bannerView
                               attribute:NSLayoutAttributeBottom
                               relatedBy:NSLayoutRelationEqual
                                  toItem:self.view.safeAreaLayoutGuide
                               attribute:NSLayoutAttributeBottom
                              multiplier:1
                                constant:0],
    [NSLayoutConstraint constraintWithItem:bannerView
                               attribute:NSLayoutAttributeCenterX
                               relatedBy:NSLayoutRelationEqual
                                  toItem:self.view
                               attribute:NSLayoutAttributeCenterX
                              multiplier:1
                                constant:0]
                                ]];
}
  
@end

Observe que, nesse caso, não fornecemos restrições de largura ou altura, pois o O tamanho do anúncio fornecido dará ao banner um tamanho intrínseco do conteúdo para dimensionar visualização.

Criador de interfaces

Um GADBannerView pode ser adicionado a um storyboard ou um xib . Ao usar esse método, adicione apenas restrições de posição banner. Por exemplo, ao exibir um banner adaptativo na parte de baixo da tela, defina a parte inferior da visualização do banner igual à parte superior da Parte inferior Guia de layout e defina o X central igual ao X central da supervisão.

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

Swift

  bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth)

Objective-C

  self.bannerView.adSize = GADCurrentOrientationAnchoredAdaptiveBannerAdSizeWithWidth(viewWidth);

Carregar um anúncio

Quando a GADBannerView estiver pronta e as propriedades dela, é hora de carregar um anúncio. Para isso, chame loadRequest: em uma GADRequest objeto:

Swift

override func viewDidLoad() {
  super.viewDidLoad()
  ...
  
  //  Set the ad unit ID and view controller that contains the GADBannerView.
  bannerView.adUnitID = "ca-app-pub-3940256099942544/2435281174"
  bannerView.rootViewController = self

  bannerView.load(GADRequest())
}

Objective-C

-   (void)viewDidLoad {
  [super viewDidLoad];
  ...
  
  //  Set the ad unit ID and view controller that contains the GADBannerView.
  self.bannerView.adUnitID = @"ca-app-pub-3940256099942544/2435281174";
  self.bannerView.rootViewController = self;

  [self.bannerView loadRequest:[GADRequest request]];
}

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

Se o anúncio não é carregado, você não precisa solicitar outro explicitamente como desde que você tenha configurado o bloco de anúncios para ser atualizado. o SDK dos anúncios para dispositivos móveis do Google respeite qualquer taxa de atualização especificada na AdMob de ML pela UI. Se você não ativou a atualização, vai precisar emitir uma nova solicitação.

Eventos de anúncio

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

Como registrar eventos de banner

Para se inscrever em eventos de anúncios de banner, defina a propriedade delegate como GADBannerView em um objeto que implementa o GADBannerViewDelegate. Geralmente, a classe que implementa o banner também age como a classe delegada. Nesse caso, a propriedade delegate pode ser definido como self.

Swift

import GoogleMobileAds
import UIKit

class ViewController: UIViewController, GADBannerViewDelegate {

  var bannerView: GADBannerView!

  override func viewDidLoad() {
    super.viewDidLoad()
    ...
    bannerView.delegate = self
  }
}

Objective-C

@import GoogleMobileAds;

@interface ViewController () <GADBannerViewDelegate>

@property(nonatomic, strong) GADBannerView *bannerView;

@end

@implementation ViewController

-   (void)viewDidLoad {
  [super viewDidLoad];
  ...
  self.bannerView.delegate = self;
}

Implementação de eventos de banner

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

Swift

func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
  print("bannerViewDidReceiveAd")
}

func bannerView(_ bannerView: GADBannerView, didFailToReceiveAdWithError error: Error) {
  print("bannerView:didFailToReceiveAdWithError: \(error.localizedDescription)")
}

func bannerViewDidRecordImpression(_ bannerView: GADBannerView) {
  print("bannerViewDidRecordImpression")
}

func bannerViewWillPresentScreen(_ bannerView: GADBannerView) {
  print("bannerViewWillPresentScreen")
}

func bannerViewWillDismissScreen(_ bannerView: GADBannerView) {
  print("bannerViewWillDIsmissScreen")
}

func bannerViewDidDismissScreen(_ bannerView: GADBannerView) {
  print("bannerViewDidDismissScreen")
}

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");
}

Veja o exemplo de delegado de anúncio para obter uma implementação de métodos de delegado de banner em o app de demonstração da API do iOS.

Swift (link em inglês) Objective-C

Casos de uso

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

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

Você pode adiar a adição de um GADBannerView ao da hierarquia de visualização até que um anúncio seja recebido. Você pode fazer isso ouvindo para o evento bannerViewDidReceiveAd::

Swift

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

Objective-C

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

Animação de um anúncio de banner

Também é possível usar o evento bannerViewDidReceiveAd: para animar um anúncio de banner uma vez. ele será retornado, conforme mostrado neste exemplo:

Swift

func bannerViewDidReceiveAd(_ bannerView: GADBannerView) {
  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;
  }];
}

Como 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, registrar-se nesses GADBannerViewDelegate.

Para capturar todos os tipos de apresentações de sobreposição ou invocações de navegador externo, não somente aqueles provenientes de cliques nos anúncios, é melhor seu aplicativo prestar atenção no equivalentes em UIViewController ou UIApplication. Aqui está uma tabela mostrando os métodos do iOS equivalentes que são invocados ao mesmo tempo que GADBannerViewDelegate métodos:

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

Outros recursos

Exemplos no GitHub

Exemplo de anúncios de banner adaptativo fixo: Swift | Objective-C

Demonstração de recursos avançados: Swift | Objective-C

Próximas etapas

Banners que podem ser recolhidos

Os anúncios de banner que podem ser recolhidos são exibidos inicialmente como um banner maior com um botão para recolher o anúncio em um tamanho menor. Considere usar para otimizar ainda mais seu desempenho. Consulte anúncios de banner que podem ser recolhidos para mais detalhes.

Banners adaptativos inline

Os banners adaptativos inline são maiores e mais altos em comparação com os adaptativos fixos. banners. Eles têm altura variável e podem ter a mesma altura da tela do dispositivo. É recomendável usar os banners adaptativos inline em vez dos anúncios de banner adaptativo fixo para que posicionam anúncios de banner em conteúdo rolável. Consulte Anúncios inline adaptáveis de banner para mais detalhes.

Explorar outros tópicos

Privacidade do usuário