Os anúncios de banner que podem ser recolhidos são exibidos inicialmente como um banner maior com um botão para recolhê-las ao tamanho do banner solicitado originalmente. Os anúncios de banner que podem ser recolhidos têm como objetivo melhorar o desempenho de anúncios fixos que caso contrário, são menores. Este guia mostra como ativar o banner que pode ser recolhido para posições de banner.
Pré-requisitos
Implementação
Verifique se a visualização do banner está definida com o tamanho que você quer mostrar aos usuários
no estado de banner normal (recolhido). Incluir um parâmetro de extras no anúncio
solicitação com collapsible
como a chave e a posição do anúncio como o valor.
O posicionamento que pode ser recolhido define como a região expandida é fixada no banner anúncio.
Valor Placement
|
Comportamento | Caso de uso pretendido |
---|---|---|
top |
A parte superior do anúncio expandido é alinhada à parte superior do anúncio recolhido. | O anúncio é posicionado na parte superior da tela. |
bottom |
A parte inferior do anúncio expandido se alinha à parte inferior do anúncio recolhido. anúncio. | O anúncio é posicionado na parte inferior da tela. |
Se o anúncio carregado for um banner que pode ser recolhido, ele mostrará o banner que pode ser recolhido sobreposição imediatamente após ser colocado na hierarquia de visualização.
Java
private void loadBannerAd() {
adView = new AdView(this);
adView.setAdUnitId("ca-app-pub-3940256099942544/2014213617")
AdSize adSize = getAdSize();
adView.setAdSize(adSize);
// Create an extra parameter that aligns the bottom of the expanded ad to
// the bottom of the bannerView.
Bundle extras = new Bundle();
extras.putString("collapsible", "bottom");
AdRequest adRequest = new AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build();
adView.loadAd(adRequest);
}
Kotlin
private fun loadBanner() {adView = AdView(this);
adView.adUnitId = "ca-app-pub-3940256099942544/2014213617"
adView.setAdSize(adSize)
// Create an extra parameter that aligns the bottom of the expanded ad to
// the bottom of the bannerView.
val extras = Bundle()
extras.putString("collapsible", "bottom")
val adRequest = AdRequest.Builder()
.addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
.build()
adView.loadAd(adRequest)
}
Comportamento de atualização dos anúncios
A atualização dos anúncios de banner que pode ser recolhido para que sejam exibidos a cada 30 a 120 segundos pode ser
muito frequentes, levando a uma experiência do usuário frustrante. Para apps que configuram
atualização automática na interface da Web da AdMob,
exibir somente a primeira solicitação de anúncio como recolhível e as próximas
anúncios de banner atualizados naquele espaço, no tamanho da solicitação original. Para
faça isso, transmita um UUID como um collapsible_request_id
à solicitação de anúncio:
Java
extras.putString("collapsible_request_id", UUID.randomUUID().toString());
Kotlin
extras.putString("collapsible_request_id", UUID.randomUUID().toString())
Se quiser carregar outro anúncio de banner que pode ser recolhido mais tarde na sessão, carregar um anúncio manualmente com uma solicitação que contém o parâmetro "collapsible".
Verificar se um anúncio carregado pode ser recolhido
Chame isCollapsible
para verificar se o último banner carregado pode ser recolhido.
Se a solicitação não for carregada e o banner anterior puder ser recolhido, a API
retorna verdadeiro.
Java
public void onAdLoaded() {
Log.i(TAG, String.format("The last loaded banner is %scollapsible.", adView.isCollapsible() ? "" : "not "));
}
Kotlin
fun onAdLoaded() {
Log.i(TAG, "The last loaded banner is ${if (adView.isCollapsible) "" else "not "}collapsible.")
}
Mediação
Os anúncios de banner que podem ser recolhidos estão disponíveis apenas para a demanda do Google na versão Beta período Os anúncios veiculados por mediação são exibidos como anúncios de banner normais e não recolhíveis.
Comportamento de veiculação dos anúncios
Para maximizar a performance dos anúncios de banner, os anúncios que não são compatíveis com pode retornar algumas solicitações de banner que podem ser recolhidos e renderizar imediatamente no tamanho de banner normal.