Los anuncios de Squeezeback insertan el contenido de tu app en una vista más pequeña y muestran un anuncio nativo en el espacio circundante. Este formato permite que los usuarios interactúen con tu app mientras el anuncio permanece visible. Elige este formato para mostrar anuncios que no cubran el contenido de tu app.
En esta guía, se explica cómo solicitar y mostrar anuncios de squeezeback en tu app con GMA Next-Gen SDK.
Antes de comenzar
Antes de continuar, haz lo siguiente:
Instala la versión
1.7.0o una posterior de GMA Next-Gen SDK.Habilita los anuncios de prueba y usa el siguiente ID de unidad de anuncios nativos de prueba:
/21775744923/example/squeezeback
Carga un anuncio
Para cargar un objeto SqueezebackAd, crea una solicitud de anuncio y llama al método load. En el siguiente ejemplo, se guarda el anuncio de squeezeback cargado, se registra para recibir eventos de anuncios y se registra un error en caso de que se produzca un error:
Kotlin
Java
Reemplaza AD_UNIT_ID por tu ID de unidad de anuncios.
Muestra el anuncio
Para mostrar el anuncio de squeezeback en pantalla, llama al 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."); } }
Establece el color de fondo de resguardo
De forma predeterminada, GMA Next-Gen SDK muestra un fondo gris oscuro detrás del contenido de la app y el anuncio reducidos. Para personalizar este color, especifica un color de fondo de resguardo en las opciones de anuncios cuando lo muestres. En el siguiente ejemplo, se establece el color de fondo de resguardo en gris oscuro y se muestra el anuncio:
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."); } }
Escucha los eventos de anuncios
Para controlar los eventos del ciclo de vida de los anuncios de squeezeback, regístrate para recibir eventos de anuncios antes de mostrarlos. Estos eventos informan las interacciones con los anuncios, como los clics y las impresiones. Estos eventos también informan eventos específicos de squeezeback, como cuando el anuncio se muestra, no se muestra o se oculta.
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()); } }); }
Después de que el usuario descarta el anuncio, GMA Next-Gen SDK invoca el evento de anuncio oculto y ya no puedes volver a mostrar el anuncio.
Oculta el anuncio
Para quitar el anuncio y restablecer el contenido de tu app al tamaño completo, llama al método hide. Este método invoca el evento de anuncio oculto. En el siguiente ejemplo, se verifica si hay una referencia de anuncio de squeezeback guardada y, si está disponible, se oculta el anuncio:
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."); } }
Cómo liberar los recursos de un anuncio
Para evitar fugas de memoria, quita la referencia al objeto de anuncio cuando tu app termine de usarlo. En el siguiente ejemplo, se limpia el anuncio:
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; } }