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.
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 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 Banners do Android:
ca-app-pub-3940256099942544/9214589741
Ele foi configurado especialmente para retornar anúncios de teste para cada solicitação, e você pode usá-lo nos seus próprios apps durante a programação, o teste e a depuração. Apenas certifique-se de e substitua-o pelo seu próprio ID do bloco de anúncios antes de publicar o app.
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.
Adicionar BoM ao layout
A primeira etapa para exibir um banner é posicionar AdView
no layout do seu app:
Java
// Create a new ad view.
adView = new AdView(this);
adView.setAdUnitId(AD_UNIT_ID);
adView.setAdSize(getAdSize());
// Replace ad container with new ad view.
adContainerView.removeAllViews();
adContainerView.addView(adView);
Kotlin
// Create a new ad view.
val adView = AdView(this)
adView.adUnitId = AD_UNIT_ID
adView.setAdSize(adSize)
this.adView = adView
// Replace ad container with new ad view.
binding.adViewContainer.removeAllViews()
binding.adViewContainer.addView(adView)
Carregar um anúncio
Quando a BoM estiver pronta, a próxima etapa é
carregar um anúncio. Isso é feito com o loadAd()
na classe AdView
. É necessário um AdRequest
, que contém informações sobre o tempo de execução, como informações de segmentação, sobre um
única solicitação de anúncio.
Confira um exemplo que mostra como carregar um anúncio:
Java
// Start loading the ad in the background.
AdRequest adRequest = new AdRequest.Builder().build();
adView.loadAd(adRequest);
Kotlin
// Start loading the ad in the background.
val adRequest = AdRequest.Builder().build()
adView.loadAd(adRequest)
Se o anúncio não carregar, não é preciso 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 interface da Web do usuário. Se não tiver ativado a atualização, você precisará emitir um novo solicitação.
Pronto! Agora seu app está pronto para exibir anúncios de banner.
Eventos de anúncio
É possível detectar vários eventos no ciclo de vida do anúncio, incluindo carregamento, impressão e clique de anúncio, bem como eventos de abertura e fechamento do anúncio. É recomendado para definir a chamada de retorno antes de carregar o banner.Java
adView.setAdListener(new AdListener() {
@Override
public void onAdClicked() {
// Code to be executed when the user clicks on an ad.
}
@Override
public void onAdClosed() {
// Code to be executed when the user is about to return
// to the app after tapping on an ad.
}
@Override
public void onAdFailedToLoad(LoadAdError adError) {
// Code to be executed when an ad request fails.
}
@Override
public void onAdImpression() {
// Code to be executed when an impression is recorded
// for an ad.
}
@Override
public void onAdLoaded() {
// Code to be executed when an ad finishes loading.
}
@Override
public void onAdOpened() {
// Code to be executed when an ad opens an overlay that
// covers the screen.
}
});
Kotlin
adView.adListener = object: AdListener() {
override fun onAdClicked() {
// Code to be executed when the user clicks on an ad.
}
override fun onAdClosed() {
// Code to be executed when the user is about to return
// to the app after tapping on an ad.
}
override fun onAdFailedToLoad(adError : LoadAdError) {
// Code to be executed when an ad request fails.
}
override fun onAdImpression() {
// Code to be executed when an impression is recorded
// for an ad.
}
override fun onAdLoaded() {
// Code to be executed when an ad finishes loading.
}
override fun onAdOpened() {
// Code to be executed when an ad opens an overlay that
// covers the screen.
}
}
Cada um dos métodos substituíveis
AdListener
corresponde a um evento no ciclo de vida de um anúncio.
Métodos substituíveis | |
---|---|
onAdClicked() |
O onAdClicked()
é invocado quando é registrado um clique em um anúncio.
|
onAdClosed() |
O onAdClosed()
é invocado quando um usuário retorna ao aplicativo depois de visualizar o
URL de destino. Seu app pode usá-lo para retomar atividades suspensas ou
e realizar qualquer outro trabalho necessário para ficar pronto para interação.
Consulte a Central de Ajuda
Exemplo de AdListener de uma implementação dos métodos de listener de anúncios na
App de demonstração da API do Android.
|
onAdFailedToLoad() |
O onAdFailedToLoad()
é o único que inclui um parâmetro. O parâmetro de erro do tipo
LoadAdError descreve o erro. Para mais informações,
consulte a página Depuração de erros de carregamento de anúncios
Documentação.
|
onAdImpression() |
O onAdImpression()
é invocado quando uma impressão é registrada para um anúncio.
|
onAdLoaded() |
O onAdLoaded()
é executado quando um anúncio termina de carregar. Se você quiser adiar
como adicionar o AdView
à sua atividade ou fragmento até ter certeza de que um anúncio será carregado, por
você pode fazer isso aqui.
|
onAdOpened() |
O onAdOpened()
é invocado quando um anúncio abre uma sobreposição que cobre a tela.
|
Aceleração de hardware para anúncios em vídeo
Para que os anúncios em vídeo sejam exibidos com sucesso nas visualizações do seu anúncio de banner, o hardware acceleration precisa estar ativado.
A aceleração de hardware é ativada por padrão, mas alguns apps podem optar por desativá-la
reimplantá-lo. Se isso se aplica ao seu aplicativo, recomendamos ativar a aceleração de hardware para
Classes Activity
que usam anúncios.
Como ativar a aceleração de hardware
Se o app não se comportar corretamente com a aceleração de hardware ativada
globalmente, também é possível controlá-lo para atividades individuais. Para ativar ou
desativar a aceleração de hardware, use o método android:hardwareAccelerated
para o atributo
<application>
e
<activity>
elementos em AndroidManifest.xml
. O exemplo abaixo ativa
para todo o app, mas a desativa para uma atividade:
<application android:hardwareAccelerated="true">
<!-- For activities that use ads, hardwareAcceleration should be true. -->
<activity android:hardwareAccelerated="true" />
<!-- For activities that don't use ads, hardwareAcceleration can be false. -->
<activity android:hardwareAccelerated="false" />
</application>
Consulte a página sobre aceleração de hardware guia para saber mais informações sobre opções para controlar a aceleração de hardware. Observe que visualizações de anúncios individuais não podem ser ativadas para aceleração de hardware se a atividade está desativada, então a própria atividade precisa ter a aceleração de hardware ativada.
Outros recursos
Exemplos no GitHub
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 que recolha o anúncio para 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 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.