InterstitialAd

abstract class InterstitialAd

Subclases directas conocidas
AdManagerInterstitialAd

Experiencia de anuncio de página completa en puntos de transición naturales, como un cambio de página, el inicio de una aplicación o la carga de un nivel de juego para los publicadores de Google Ad Manager.

Una experiencia de anuncio de página completa en puntos de transición naturales, como un cambio de página, el inicio de una app o la carga de un nivel de juego. Los anuncios intersticiales usan un botón de cierre que quita el anuncio de la experiencia del usuario.

Código de muestra: 

public class MyActivity extends Activity {
    private InterstitialAd interstitialAd;
    private Button nextLevelButton;
    private TextView textView;

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // Create a full screen content callback.
        FullScreenContentCallback fullScreenContentCallback = new FullScreenContentCallback() {
            @Override
            public void onAdDismissedFullScreenContent() {
               interstitialAd = null;
               // Proceed to the next level.
               goToNextLevel();
            }
        };

        // Load an interstitial ad. When a natural transition in the app occurs (such as a level
        // ending in a game), show the interstitial. In this simple example, the press of a
        // button is used instead.
        //
        // If the button is clicked before the interstitial is loaded, the user should proceed to
        // the next part of the app (in this case, the next level).
        //
        // If the interstitial is finished loading, the user will view the interstitial before
        // proceeding.
        InterstitialAd.load(
            this,
            "myAdUnitId",
            new AdRequest.Builder().build(),
            new InterstitialAdLoadCallback() {
                @Override
                public void onAdLoaded(@NonNull InterstitialAd ad) {
                    interstitialAd = ad;
                    interstitialAd.setFullScreenContentCallback(fullScreenContentCallback);
                }

                @Override
                public void onAdFailedToLoad(@NonNull LoadAdError adError) {
                    // Code to be executed when an ad request fails.
                }
            });

        // Create the button to go to the next level.
        nextLevelButton = new Button(this);
        nextLevelButton.setText("Next Level");
        nextLevelButton.setOnClickListener(new View.OnClickListener() {
            @Override
            public void onClick(View view) {
                // Show the interstitial if it is ready. Otherwise, proceed to the next level
                // without ever showing it.
                if (interstitialAd != null) {
                    interstitialAd.show(MyActivity.this);
                } else {
                    // Proceed to the next level.
                    goToNextLevel();
                }
            }
        });

        // Add the next level button to the layout.
        LinearLayout layout = new LinearLayout(this);
        layout.setOrientation(LinearLayout.VERTICAL);
        layout.addView(nextLevelButton);

        // Create a TextView to display the current level.
        textView = new TextView(this);
        textView.setText("Level 1");
        layout.addView(textView);

        setContentView(layout);
    }

    public void goToNextLevel() {
        // Show the next level, and disable the next level button since there are no more levels.
        nextLevelButton.setEnabled(false);
        textView.setText("Level 2");
    }
}

Resumen

Constructores públicos

Funciones públicas
abstract String

Devuelve el ID de la unidad de anuncios.
abstract FullScreenContentCallback?

Obtiene el FullScreenContentCallback para este InterstitialAd.
abstract OnPaidEventListener?

Obtiene el OnPaidEventListener para este InterstitialAd.
abstract Long

Devuelve el ID de posición de este InterstitialAd.
abstract ResponseInfo

Devuelve el objeto ResponseInfo del anuncio cargado.
java-static Boolean
isAdAvailable(context: Context, adUnitId: String)

Esta función es obsoleta.

En su lugar, usa isAdAvailable.
java-static Unit
load(
    context: Context,
    adUnitId: String,
    adRequest: AdRequest,
    loadCallback: InterstitialAdLoadCallback
)

Carga un InterstitialAd.
java-static InterstitialAd?
pollAd(context: Context, adUnitId: String)

Esta función es obsoleta.

En su lugar, usa pollAd.
abstract Unit
setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
)

Registra una devolución de llamada para que se invoque cuando los anuncios muestren y descarten contenido de pantalla completa.
abstract Unit
setImmersiveMode(immersiveModeEnabled: Boolean)

Establece una marca que controla si este objeto intersticial se mostrará en el modo envolvente.
abstract Unit

Registra una devolución de llamada para que se invoque cuando se estime que este anuncio generó ingresos.
abstract Unit
setPlacementId(placementId: Long)

Establece un ID de posición para el anuncio intersticial.
abstract Unit
show(activity: Activity)

Muestra el anuncio intersticial.

Constructores públicos

InterstitialAd

InterstitialAd()

Funciones públicas

getAdUnitId

abstract fun getAdUnitId(): String

Devuelve el ID de la unidad de anuncios.

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

Obtiene el FullScreenContentCallback para este InterstitialAd.

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

Obtiene el OnPaidEventListener para este InterstitialAd.

getPlacementId

abstract fun getPlacementId(): Long

Devuelve el ID de posición de este InterstitialAd.

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

Devuelve el objeto ResponseInfo del anuncio cargado. Devuelve null hasta que el anuncio se cargue correctamente.

isAdAvailable

java-static fun isAdAvailable(context: Context, adUnitId: String): Boolean

Devuelve true si hay un anuncio intersticial disponible cargado desde startPreload.

load

java-static fun load(
    context: Context,
    adUnitId: String,
    adRequest: AdRequest,
    loadCallback: InterstitialAdLoadCallback
): Unit

Carga un InterstitialAd.

Parámetros
context: Context

Es un contexto de actividad o aplicación.
adUnitId: String

Es el ID de la unidad de anuncios.
adRequest: AdRequest

Es una solicitud de anuncio con información de segmentación.
loadCallback: InterstitialAdLoadCallback

Es una devolución de llamada que se invoca cuando termina de cargarse un anuncio intersticial.

pollAd

java-static fun pollAd(context: Context, adUnitId: String): InterstitialAd?

Recupera el siguiente anuncio intersticial cargado desde startPreload o null si no hay anuncios disponibles.

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

Registra una devolución de llamada para que se invoque cuando los anuncios muestren y descarten contenido de pantalla completa.

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

Establece una marca que controla si este objeto intersticial se mostrará en el modo envolvente. Llama a este método antes de show. Durante show, si esta marca está activada y se admite el modo envolvente, se activarán SYSTEM_UI_FLAG_IMMERSIVE_STICKY y SYSTEM_UI_FLAG_HIDE_NAVIGATION para el anuncio intersticial.

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

Registra una devolución de llamada para que se invoque cuando se estime que este anuncio generó ingresos.

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

Establece un ID de posición para el anuncio intersticial.

Para asegurarte de que este ID de posición se incluya en los informes, llama a este método antes de mostrar el anuncio.

Parámetros
placementId: Long

Es un número entero largo que proporciona la IU de AdMob para la posición configurada.

mostrar

abstract fun show(activity: Activity): Unit

Muestra el anuncio intersticial.

Parámetros
activity: Activity

Es un contexto de Activity desde el que se presenta el anuncio.