Os anúncios Squeezeback inserem o conteúdo do app em uma visualização menor e mostram um anúncio nativo no espaço ao redor. Esse formato permite que os usuários interajam com o app enquanto o anúncio permanece visível. Para mostrar anúncios de display que não cobrem o conteúdo do app, escolha esse formato.
Este guia aborda como solicitar e mostrar anúncios squeezeback no seu app usando GMA Next-Gen SDK.
Antes de começar
Antes de continuar, faça o seguinte:
Instale a versão
1.7.0ou mais recente do GMA Next-Gen SDK.Ative os anúncios de teste e use este ID do bloco de anúncios nativos de teste:
/21775744923/example/squeezeback
Carregar um anúncio
Para carregar um objeto
SqueezebackAd,
crie uma solicitação de anúncio e chame o método load. O exemplo a seguir
salva o anúncio squeezeback carregado, registra eventos de anúncio e registra um
erro em caso de falha:
Kotlin
Java
Substitua AD_UNIT_ID pelo ID do seu bloco de anúncios.
Mostrar o anúncio
Para mostrar o anúncio squeezeback na tela, chame o método show:
Kotlin
private fun showSqueezebackAd(activity: Activity) { // Capture the ad reference saved from the onAdLoaded callback. val ad = squeezebackAd if (ad != null) { ad.show(activity) } else { Log.d(TAG, "No ad to show.") } }
Java
private void showSqueezebackAd(@NonNull Activity activity) { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { squeezebackAd.show(activity); } else { Log.d(TAG, "No ad to show."); } }
Definir a cor de fundo substituta
Por padrão, o GMA Next-Gen SDK mostra um plano de fundo cinza-escuro atrás do conteúdo reduzido do app e do anúncio. Para personalizar essa cor, especifique uma cor de plano de fundo substituta nas opções de anúncio ao mostrá-lo. O exemplo a seguir define a cor de fundo alternativa como cinza-escuro e mostra o anúncio:
Kotlin
private fun showSqueezebackAdWithFallbackBackgroundColor(activity: Activity) { // Capture the ad reference saved from the onAdLoaded callback. val ad = squeezebackAd if (ad != null) { val options = SqueezebackAdOptions.Builder() // Sets the fallback background color for the space behind the shrunken content and ad. .setFallbackBackgroundColor(Color.DKGRAY) .build() ad.show(activity, options) } else { Log.d(TAG, "No ad to show.") } }
Java
private void showSqueezebackAdWithFallbackBackgroundColor(@NonNull Activity activity) { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { SqueezebackAdOptions options = new SqueezebackAdOptions.Builder() // Sets the fallback background color for the space behind the shrunken content and // ad. .setFallbackBackgroundColor(Color.DKGRAY) .build(); squeezebackAd.show(activity, options); } else { Log.d(TAG, "No ad to show."); } }
Detectar eventos de anúncios
Para processar eventos de ciclo de vida de anúncios squeezeback, registre-se para eventos de anúncios antes de mostrar seu anúncio. Esses eventos informam interações com o anúncio, como cliques e impressões. Esses eventos também informam eventos específicos de squeezeback, como quando o anúncio é mostrado, não é mostrado ou é ocultado.
Kotlin
private fun setAdEventCallback(squeezebackAd: SqueezebackAd) { squeezebackAd.adEventCallback = object : SqueezebackAdEventCallback { override fun onAdShown() { Log.d(TAG, "Squeezeback ad shown.") } override fun onAdHidden() { // Called when hide() is invoked or the user taps the close button. // The ad cannot be shown again after it is hidden. Log.d(TAG, "Squeezeback ad hidden.") } override fun onAdFailedToShow(error: FullScreenContentError) { Log.w(TAG, "Squeezeback ad failed to show: $error") } override fun onAdImpression() { Log.d(TAG, "Squeezeback ad recorded an impression.") } override fun onAdClicked() { Log.d(TAG, "Squeezeback ad recorded a click.") } override fun onAdShowedFullScreenContent() { Log.d(TAG, "Squeezeback ad showed full screen content.") } override fun onAdDismissedFullScreenContent() { Log.d(TAG, "Squeezeback ad dismissed full screen content.") } override fun onAdFailedToShowFullScreenContent( fullScreenContentError: FullScreenContentError ) { Log.w(TAG, "Squeezeback ad failed to show full screen content: $fullScreenContentError") } override fun onAdPaid(value: AdValue) { Log.d(TAG, "Squeezeback ad paid: ${value.valueMicros} ${value.currencyCode}") } } }
Java
private void setAdEventCallback(@NonNull SqueezebackAd squeezebackAd) { squeezebackAd.setAdEventCallback( new SqueezebackAdEventCallback() { @Override public void onAdShown() { Log.d(TAG, "Squeezeback ad shown."); } @Override public void onAdHidden() { // Called when hide() is invoked or the user taps the close button. // The ad cannot be shown again after it is hidden. Log.d(TAG, "Squeezeback ad hidden."); } @Override public void onAdFailedToShow(@NonNull FullScreenContentError error) { Log.w(TAG, "Squeezeback ad failed to show: " + error); } @Override public void onAdImpression() { Log.d(TAG, "Squeezeback ad recorded an impression."); } @Override public void onAdClicked() { Log.d(TAG, "Squeezeback ad recorded a click."); } @Override public void onAdShowedFullScreenContent() { Log.d(TAG, "Squeezeback ad showed full screen content."); } @Override public void onAdDismissedFullScreenContent() { Log.d(TAG, "Squeezeback ad dismissed full screen content."); } @Override public void onAdFailedToShowFullScreenContent( @NonNull FullScreenContentError fullScreenContentError) { Log.w( TAG, "Squeezeback ad failed to show full screen content: " + fullScreenContentError); } @Override public void onAdPaid(@NonNull AdValue value) { Log.d( TAG, "Squeezeback ad paid: " + value.getValueMicros() + " " + value.getCurrencyCode()); } }); }
Depois que o usuário dispensar o anúncio, o GMA Next-Gen SDK vai invocar o evento de anúncio oculto, e não será mais possível mostrar o anúncio novamente.
Ocultar o anúncio
Para remover o anúncio e restaurar o conteúdo do app para o tamanho original, chame o método hide. Esse método invoca o evento de anúncio oculto. O exemplo a seguir verifica
se há uma referência de anúncio squeezeback salva e oculta o anúncio, se disponível:
Kotlin
private fun hideSqueezebackAd() { // Capture the ad reference saved from the onAdLoaded callback. val ad = squeezebackAd if (ad != null) { ad.hide() } else { Log.d(TAG, "No ad to hide.") } }
Java
private void hideSqueezebackAd() { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { squeezebackAd.hide(); } else { Log.d(TAG, "No ad to hide."); } }
Limpar recursos de anúncio
Para evitar vazamentos de memória, remova a referência ao objeto de anúncio quando o app terminar de usá-lo. O exemplo a seguir limpa o anúncio:
Kotlin
private fun cleanUpSqueezebackAd() { squeezebackAd?.destroy() squeezebackAd = null }
Java
private void cleanUpSqueezebackAd() { // Use the ad reference saved from the onAdLoaded callback. if (squeezebackAd != null) { squeezebackAd.destroy(); squeezebackAd = null; } }