Anúncios de banner

Os anúncios de banner ocupam um espaço no layout do app, na parte superior ou inferior da tela do dispositivo. Eles permanecem na tela enquanto os usuários interagem com o app e podem ser atualizados automaticamente após um determinado período. Se você começou a usar os anúncios para dispositivos móveis agora, saiba que eles são um bom lugar para começar. Estudo de caso.

Pré-requisitos

• Conclua a etapa Começar.
• (somente Android) Familiaridade em trabalhar com referências jobject do JNI. Consulte Dicas de JNI do Android.

Sempre teste com anúncios de teste

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

A maneira mais fácil de carregar anúncios de teste é usar o ID dedicado do bloco de anúncios de teste para banners, que varia de acordo com a plataforma do dispositivo:

• Android: ca-app-pub-3940256099942544/6300978111
• iOS: ca-app-pub-3940256099942544/2934735716

Esses IDs de bloco de anúncios foram configurados especialmente para retornar anúncios de teste para cada solicitação. Você pode usá-los nos seus próprios apps durante a programação, o teste e a depuração. Basta substituí-lo pelo seu próprio ID de 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.

Implementação

Configurar um AdView

Os anúncios de banner são exibidos em objetos AdView. Portanto, a primeira etapa para integrar anúncios de banner é criar e posicionar um AdView.

1. Adicione este cabeçalho ao código C++ do app:

    #include "firebase/gma/ad_view.h"

2. Declare e instancie um objeto AdView:

     firebase::gma::AdView* ad_view;
     ad_view = new firebase::gma::AdView();

3. Crie um AdSize e inicialize a visualização de anúncio usando a visualização mãe AdParent. A visualização pai é uma referência jobject JNI a um Activity do Android ou um ponteiro para um UIView do iOS convertido em um tipo AdParent:

    // my_ad_parent is a jobject reference
    // to an Android Activity or a pointer to an iOS UIView.
    firebase::gma::AdParent ad_parent = static_cast<firebase::gma::AdParent>(my_ad_parent);
    firebase::Future result =
      ad_view->Initialize(ad_parent, kBannerAdUnit, firebase::gma::AdSize::kBanner);

4. Como alternativa para manter o futuro como uma variável, é possível verificar periodicamente o status da operação de inicialização invocando InitializeLastResult() no objeto AdView. Isso pode ser útil para acompanhar o processo de inicialização no loop global do jogo.

     // Monitor the status of the future in your game loop:
     firebase::Future<void> result = ad_view->InitializeLastResult();
     if (result.status() == firebase::kFutureStatusComplete) {
       // Initialization completed.
       if(future.error() == firebase::gma::kAdErrorCodeNone) {
         // Initialization successful.
       } else {
         // An error has occurred.
       }
     } else {
       // Initialization on-going.
     }
   

5. Para mais informações sobre como trabalhar com firebase::Future, consulte Usar Futures para monitorar o status de conclusão das chamadas de método.

Definir a posição do anúncio

É possível definir a posição do AdView a qualquer momento após a inicialização:

firebase::Future<void> result = ad_view->SetPosition(firebase::gma::AdView::kPositionTop);

Carregar um anúncio

Você pode carregar um anúncio depois que o AdView for inicializado:

firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result = ad_view->LoadAd(my_ad_request);

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

Mostrar o anúncio

Por fim, chame Show() para mostrar o anúncio na tela. Esse método pode ser invocado a qualquer momento após a inicialização do anúncio:

firebase::Future<void> result = ad_view->Show();

Eventos de anúncio

O SDK dos anúncios para dispositivos móveis do Google para C++ oferece uma classe AdListener que pode ser estendida e transmitida para AdView::SetListener() para receber notificações sobre alterações no estado da visualização do anúncio.

A extensão de métodos em AdListener é opcional, então você só precisa implementar os métodos que quiser. Confira abaixo um exemplo de implementação de uma classe que estende todos os métodos da classe AdListener:

class ExampleAdListener
    : public firebase::gma::AdListener {
 public:
  ExampleAdListener() {}
  void OnAdClicked() override {
    // This method is invoked when the user clicks the ad.
  }

  void OnAdClosed() override {
   // This method is invoked when the user closes the ad.
  }

  void OnAdImpression() override {
    // This method is invoked when an impression is recorded for an ad.
  }

  void OnAdOpened() override {
    // This method is invoked when an ad opens an overlay that covers the screen.
  }
};

ExampleAdListener* ad_listener = new ExampleAdListener();
ad_view->SetAdListener(ad_listener);

Tamanhos de banner

A tabela abaixo lista os tamanhos de banner padrão.

Tamanhos de anúncio personalizados

Para definir um tamanho de banner personalizado, defina as dimensões desejadas usando o construtor firebase::gma::AdSize com parâmetros de largura e altura, conforme mostrado aqui:

firebase::gma::AdSize ad_size(/*width=*/320, /*height=*/50);

Outros recursos

Exemplo no GitHub

• Confira o código-fonte do nosso exemplo de app de início rápido no GitHub.

Histórias de sucesso

• Exemplo de caso de uso.