InterstitialAd

public 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 app 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

Métodos públicos

abstract @NonNull String

Devuelve el ID de la unidad de anuncios.

abstract @Nullable FullScreenContentCallback

Obtiene el FullScreenContentCallback para este InterstitialAd.

abstract @Nullable OnPaidEventListener

Obtiene el OnPaidEventListener para este InterstitialAd.

abstract long

Devuelve el ID de la posición de este InterstitialAd.

abstract @NonNull ResponseInfo

Devuelve el objeto ResponseInfo del anuncio cargado.

static boolean
isAdAvailable(@NonNull Context context, @NonNull String adUnitId)

Este método dejó de estar disponible.

Usa isAdAvailable en su lugar.

static void
load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdRequest adRequest,
    @NonNull InterstitialAdLoadCallback loadCallback
)

Carga un InterstitialAd.

static @Nullable InterstitialAd
pollAd(@NonNull Context context, @NonNull String adUnitId)

Este método dejó de estar disponible.

Usa pollAd en su lugar.

abstract void

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

abstract void
setImmersiveMode(boolean immersiveModeEnabled)

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

abstract void

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

abstract void
setPlacementId(long placementId)

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

abstract void
show(@NonNull Activity activity)

Muestra el anuncio intersticial.

Constructores públicos

InterstitialAd

public InterstitialAd()

Métodos públicos

getAdUnitId

public abstract @NonNull String getAdUnitId()

Devuelve el ID de la unidad de anuncios.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

Obtiene el FullScreenContentCallback para este InterstitialAd.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Obtiene el OnPaidEventListener para este InterstitialAd.

getPlacementId

public abstract long getPlacementId()

Devuelve el ID de la posición de este InterstitialAd.

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

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

isAdAvailable

public static boolean isAdAvailable(@NonNull Context context, @NonNull String adUnitId)

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

load

public static void load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdRequest adRequest,
    @NonNull InterstitialAdLoadCallback loadCallback
)

Carga un InterstitialAd.

Parámetros
@NonNull Context context

Es un contexto de actividad o aplicación.

@NonNull String adUnitId

Es el ID de la unidad de anuncios.

@NonNull AdRequest adRequest

Es una solicitud de anuncio con información de segmentación.

@NonNull InterstitialAdLoadCallback loadCallback

Es una devolución de llamada que se invocará cuando un anuncio intersticial termine de cargarse.

pollAd

public static @Nullable InterstitialAd pollAd(@NonNull Context context, @NonNull String adUnitId)

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

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

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

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

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

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

setPlacementId

public abstract void setPlacementId(long placementId)

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
long placementId

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

mostrar

public abstract void show(@NonNull Activity activity)

Muestra el anuncio intersticial.

Parámetros
@NonNull Activity activity

Es un contexto de Activity desde el que se presentará el anuncio.