São anúncios em tela cheia que cobrem a interface de um app até serem fechados pelo usuário. Normalmente, elas aparecem em pontos de transição natural no fluxo de um app, como entre atividades ou durante a pausa entre níveis de um jogo. Quando um app mostra um anúncio intersticial, o usuário tem a opção de tocar nele e seguir até o destino ou fechá-lo e retornar ao app. Estudo de caso (link em inglês).
Este guia mostra como integrar anúncios intersticiais em apps Android e iOS usando o SDK dos anúncios para dispositivos móveis do Google para C++.
Pré-requisitos
- Conclua os Primeiros passos.
- (Somente Android) Familiaridade com referências de
jobject
da 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 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 é usando nosso ID de bloco de anúncios de teste dedicado para intersticiais, que varia de acordo com a plataforma do dispositivo:
- Android:
ca-app-pub-3940256099942544/1033173712
- iOS:
ca-app-pub-3940256099942544/4411468910
Eles foram configurados especialmente para retornar anúncios de teste para cada solicitação, e você pode usá-los nos seus próprios apps durante a programação, os testes e a depuração. Não se esqueça de substituí-lo pelo seu próprio ID do 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
As principais etapas para integrar os anúncios intersticiais são:
- Carregar um anúncio.
- Registre-se para callbacks.
- Exiba o anúncio e processe os eventos do ciclo de vida dele.
Configurar um InterstitialAd
Os anúncios intersticiais são exibidos em objetos InterstitialAd
. Portanto, a primeira etapa
para integrar anúncios intersticiais ao seu app é criar e inicializar um
objeto InterstitialAd
.
Adicione o seguinte cabeçalho ao código C++ do app:
#include "firebase/gma/interstial_ad.h"
Declare e instancie um objeto
InterstitialAd
:firebase::gma::InterstitialAd* interstitial_ad; interstitial_ad = new firebase::gma::InterstitialAd();
Inicialize a instância de
InterstitialAd
usando a transmissão de visualização mãe para um tipoAdParent
. A visualização mãe é uma referência JNIjobject
a umActivity
do Android ou um ponteiro para umUIView
do iOS.// 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<void> result = interstitial_ad->Initialize(ad_parent);
Como alternativa à retenção do futuro como uma variável, você pode verificar periodicamente o status da operação de inicialização invocando
InitializeLastResult()
no objetoInterstitialAd
. Isso pode ser útil para acompanhar o processo de inicialização no seu loop de jogo global.// Monitor the status of the future in your game loop: firebase::Future<void> result = interstitial_ad->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. }
Para mais informações sobre como trabalhar com firebase::Future
, consulte
Usar Futures para monitorar o status de conclusão de chamadas de
método.
Carregar um anúncio
É possível carregar um anúncio usando o método LoadAd()
no
objeto InterstitialAd
. O método de carregamento requer que você tenha inicializado o objeto InterstitialAd
e que tenha o ID do bloco de anúncios e um objeto AdRequest
. É retornado um firebase::Future
que pode ser usado para monitorar o estado
e o resultado da operação de carregamento.
O código a seguir mostra como carregar um anúncio depois que o InterstitialAd
for
inicializado com sucesso:
firebase::gma::AdRequest ad_request;
firebase::Future<firebase::gma::AdResult> load_ad_result;
load_ad_result = interstitial_ad->LoadAd(interstitial_ad_unit_id, ad_request);
Registrar para callbacks
Você precisa estender a classe FullScreenContentListener
para receber notificações de apresentação de anúncios intersticiais e eventos de ciclo de vida. A subclasse
FullScreenContentListener
personalizada pode ser registrada pelo
método InterstitialAd::SetFullScreenContentListener()
e recebe
callbacks quando o anúncio é apresentado com ou sem sucesso ou quando
ele é dispensado.
O código a seguir mostra como estender a classe e atribuí-la ao anúncio:
class ExampleFullScreenContentListener : public firebase::gma::FullScreenContentListener { public: ExampleFullScreenContentListener() {} void OnAdClicked() override { // This method is invoked when the user clicks the ad. } void OnAdDismissedFullScreenContent() override { // This method is invoked when the ad dismisses full screen content. } void OnAdFailedToShowFullScreenContent(const AdError& error) override { // This method is invoked when the ad failed to show full screen content. // Details about the error are contained within the AdError parameter. } void OnAdImpression() override { // This method is invoked when an impression is recorded for an ad. } void OnAdShowedFullScreenContent() override { // This method is invoked when the ad showed its full screen content. } }; ExampleFullScreenContentListener* full_screen_content_listener = new ExampleFullScreenContentListener(); interstitial_ad->SetFullScreenContentListener(full_screen_content_listener);
InterstitialAd
é um objeto de uso único. Isso significa que, uma vez que um anúncio intersticial é exibido, ele não pode ser exibido novamente. Uma prática recomendada é carregar outro anúncio intersticial no método OnAdDismissedFullScreenContent()
da sua FullScreenContentListener
para que o próximo anúncio intersticial comece a ser carregado assim que o anterior for dispensado.
Exibir o anúncio
Os intersticiais precisam ser exibidos durante pausas naturais no fluxo de um app.
Entre os níveis de um jogo é um bom exemplo, ou depois que o usuário conclui uma tarefa.
Embora o FullScreenContentListener
possa ser usado para determinar quando um anúncio mostrou
o conteúdo em tela cheia, o futuro retornado por Show()
também vai sinalizar
quando o anúncio foi veiculado.
firebase::Future<void> result = interstitial_ad->Show();
Práticas recomendadas
- Avalie se os anúncios intersticiais são o tipo certo de anúncio para seu app.
- Os anúncios intersticiais funcionam melhor em apps com pontos de transição naturais. Esse ponto é criado pela conclusão de uma tarefa em um app, como compartilhar uma imagem ou concluir uma fase do jogo. Como o usuário espera uma interrupção na ação, é fácil apresentar um anúncio intersticial sem atrapalhar a experiência. Considere em quais pontos do fluxo de trabalho do seu app você exibirá anúncios intersticiais e como o usuário provavelmente responderá.
- Lembre-se de pausar a ação ao exibir um anúncio intersticial.
- Há vários tipos diferentes de anúncios intersticiais: de texto, gráficos, em vídeo e muito mais. É importante garantir que, quando o app exibir um
anúncio intersticial, ele também suspenda o uso de alguns recursos para permitir
que o anúncio os aproveite. Por exemplo, quando você fizer a chamada para mostrar um
anúncio intersticial, pause qualquer saída de áudio produzida pelo app.
É possível retomar a reprodução de sons no método
OnAdDismissedFullScreenContent
doFullScreenContentListener
instalado, que será invocado quando o usuário terminar de interagir com o anúncio. Além disso, considere interromper temporariamente qualquer tarefa de computação intensa (como um loop de jogo) enquanto o anúncio estiver sendo exibido. Isso garante que o usuário não se depare com gráficos lentos ou sem resposta nem vídeos travados. - Espere um tempo de carregamento adequado.
- Assim como é importante garantir a exibição de anúncios intersticiais no momento adequado, também é importante garantir que o usuário não precise esperar o carregamento deles. Carregar o anúncio com antecedência antes da exibição pode garantir que seu app tenha um anúncio intersticial totalmente carregado e pronto no momento da exibição.
- Não sobrecarregue o usuário com anúncios.
- Embora aumentar a frequência de anúncios intersticiais no app possa parecer uma ótima maneira de aumentar a receita, também pode prejudicar a experiência do usuário e reduzir as taxas de cliques. Garanta que os usuários não sejam interrompidos com tanta frequência de modo que não possam mais aproveitar o app.
- Não use o futuro do preenchimento automático para mostrar o intersticial.
- Isso pode causar uma experiência ruim para o usuário. Em vez disso, pré-carregue o anúncio antes de precisar exibi-lo.
Outros recursos
Exemplo no GitHub
- Veja o código-fonte do nosso app de início rápido de exemplo no GitHub.
Tutoriais em vídeo da "Mobile Ads Garage"
Histórias de sucesso
Próximas etapas
- Crie seu próprio bloco de anúncios intersticiais na interface da AdMob, caso ainda não tenha feito isso.
- Saiba mais sobre a segmentação de anúncios e as diretrizes para anúncios intersticiais.