InterstitialAd

public abstract class InterstitialAd

Classi di sottoclasse dirette note
AdManagerInterstitialAd

Un'esperienza pubblicitaria a pagina intera in punti di transizione naturali, come un cambio pagina, il lancio di un'applicazione o un caricamento di livelli di gioco per i publisher Google Ad Manager.

Un'esperienza pubblicitaria a pagina intera in punti di transizione naturali, come un cambio pagina, il lancio di un'applicazione o un caricamento di livelli di gioco. Gli interstitial utilizzano un pulsante di chiusura che rimuove l'annuncio dall'esperienza utente.

Codice di esempio: 

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");
    }
}

Riepilogo

Costruttori pubblici

Metodi pubblici
abstract @NonNull String

Restituisce l'ID unità pubblicitaria.
abstract @Nullable FullScreenContentCallback

Recupera il FullScreenContentCallback per questo InterstitialAd.
abstract @Nullable OnPaidEventListener

Recupera il OnPaidEventListener per questo InterstitialAd.
abstract @NonNull ResponseInfo

Restituisce l'oggetto ResponseInfo per l'annuncio caricato.
static boolean
isAdAvailable(@NonNull Context context, @NonNull String adUnitId)

Restituisce true se è disponibile un annuncio interstitial caricato da startPreload.
static void
load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdRequest adRequest,
    @NonNull InterstitialAdLoadCallback loadCallback
)

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

Recupera l'annuncio interstitial successivo caricato da startPreload o null se non è disponibile alcun annuncio.
abstract void

Registra un callback da chiamare quando gli annunci mostrano e ignorano i contenuti a schermo intero.
abstract void
setImmersiveMode(boolean immersiveModeEnabled)

Imposta un flag che controlla se questo oggetto interstitial verrà visualizzato in modalità immersiva.
abstract void

Registra un callback da chiamare quando si stima che questo annuncio abbia generato entrate.
abstract void
show(@NonNull Activity activity)

Mostra l'annuncio interstitial.

Costruttori pubblici

InterstitialAd

public InterstitialAd()

Metodi pubblici

getAdUnitId

public abstract @NonNull String getAdUnitId()

Restituisce l'ID unità pubblicitaria.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

Recupera il FullScreenContentCallback per questo InterstitialAd.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Recupera il OnPaidEventListener per questo InterstitialAd.

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

Restituisce l'oggetto ResponseInfo per l'annuncio caricato. Restituisce null finché l'annuncio non viene caricato correttamente.

isAdAvailable

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

Restituisce true se è disponibile un annuncio interstitial caricato da startPreload.

load

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

Carica un InterstitialAd.

Parametri
@NonNull Context context

Un contesto di attività o applicazione.
@NonNull String adUnitId

L'ID unità pubblicitaria.
@NonNull AdRequest adRequest

Una richiesta di annuncio con informazioni sul targeting.
@NonNull InterstitialAdLoadCallback loadCallback

Un callback da chiamare al termine del caricamento di un annuncio interstitial.

pollAd

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

Recupera l'annuncio interstitial successivo caricato da startPreload o null se non è disponibile alcun annuncio.

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

Registra un callback da chiamare quando gli annunci mostrano e ignorano i contenuti a schermo intero.

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

Imposta un flag che controlla se questo oggetto interstitial verrà visualizzato in modalità immersiva. Chiama questo metodo prima del giorno show. Durante show, se questo flag è attivo e la modalità immersiva è supportata, SYSTEM_UI_FLAG_IMMERSIVE_STICKY e SYSTEM_UI_FLAG_HIDE_NAVIGATION verranno attivati per l'annuncio interstitial.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

Registra un callback da chiamare quando si stima che questo annuncio abbia generato entrate.

mostra

public abstract void show(@NonNull Activity activity)

Mostra l'annuncio interstitial.

Parametri
@NonNull Activity activity

Un contesto Activity da cui presentare l'annuncio.