InterstitialAd

abstract class InterstitialAd

Bekannte direkte Unterklassen
AdManagerInterstitialAd

Nutzern wird an natürlichen Übergangspunkten wie einem Seitenwechsel, dem Start einer App oder dem Laden eines Spiele-Levels eine ganze Seite mit Werbung angezeigt.

Nutzern wird an natürlichen Übergangspunkten wie einem Seitenwechsel, dem Start einer App oder dem Laden eines Spiele-Levels eine ganze Seite mit Werbung angezeigt. Interstitial-Anzeigen haben eine Schaltfläche zum Schließen, mit der die Anzeige aus dem Sichtfeld des Nutzers entfernt wird.

Beispielcode: 

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

Zusammenfassung

Öffentliche Konstruktoren

Öffentliche Funktionen
abstract String

Gibt die Anzeigenblock-ID zurück.
abstract FullScreenContentCallback?

Ruft die FullScreenContentCallback für diese InterstitialAd ab.
abstract OnPaidEventListener?

Ruft die OnPaidEventListener für diese InterstitialAd ab.
abstract Long

Gibt die Placement-ID für diesen InterstitialAd zurück.
abstract ResponseInfo

Gibt das ResponseInfo-Objekt für die geladene Anzeige zurück.
java-static Boolean
isAdAvailable(context: Context, adUnitId: String)

Diese Funktion wurde eingestellt.

Verwenden Sie stattdessen isAdAvailable.
java-static Unit
load(
    context: Context,
    adUnitId: String,
    adRequest: AdRequest,
    loadCallback: InterstitialAdLoadCallback
)

Lädt ein InterstitialAd.
java-static InterstitialAd?
pollAd(context: Context, adUnitId: String)

Diese Funktion wurde eingestellt.

Verwenden Sie stattdessen „pollAd“.
abstract Unit
setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
)

Registriert einen Callback, der aufgerufen wird, wenn Anzeigen eingeblendet und Vollbildinhalte geschlossen werden.
abstract Unit
setImmersiveMode(immersiveModeEnabled: Boolean)

Legt ein Flag fest, mit dem gesteuert wird, ob dieses Interstitial-Objekt im immersiven Modus angezeigt wird.
abstract Unit

Registriert einen Callback, der aufgerufen wird, wenn mit dieser Anzeige voraussichtlich Einnahmen erzielt wurden.
abstract Unit
setPlacementId(placementId: Long)

Legt eine Placement-ID für die Interstitial-Anzeige fest.
abstract Unit
show(activity: Activity)

Die Interstitial-Anzeige wird eingeblendet.

Öffentliche Konstruktoren

InterstitialAd

InterstitialAd()

Öffentliche Funktionen

getAdUnitId

abstract fun getAdUnitId(): String

Gibt die Anzeigenblock-ID zurück.

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

Ruft die FullScreenContentCallback für diese InterstitialAd ab.

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

Ruft die OnPaidEventListener für diese InterstitialAd ab.

getPlacementId

abstract fun getPlacementId(): Long

Gibt die Placement-ID für diesen InterstitialAd zurück.

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

Gibt das ResponseInfo-Objekt für die geladene Anzeige zurück. Gibt null zurück, bis die Anzeige erfolgreich geladen wurde.

isAdAvailable

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

Gibt true zurück, wenn eine verfügbare Interstitial-Anzeige aus startPreload geladen wurde.

load

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

Lädt ein InterstitialAd.

Parameter
context: Context

Ein Aktivitäts- oder Anwendungskontext.
adUnitId: String

Die Anzeigenblock-ID.
adRequest: AdRequest

Eine Anzeigenanfrage mit Targeting-Informationen.
loadCallback: InterstitialAdLoadCallback

Ein Callback, der aufgerufen wird, wenn das Laden einer Interstitial-Anzeige abgeschlossen ist.

pollAd

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

Ruft die nächste Interstitial-Anzeige ab, die aus startPreload geladen wurde, oder null, wenn keine Anzeige verfügbar ist.

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

Registriert einen Callback, der aufgerufen wird, wenn Anzeigen eingeblendet und Vollbildinhalte geschlossen werden.

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

Legt ein Flag fest, mit dem gesteuert wird, ob dieses Interstitial-Objekt im immersiven Modus angezeigt wird. Rufen Sie diese Methode vor show auf. Während show werden die Flags SYSTEM_UI_FLAG_IMMERSIVE_STICKY und SYSTEM_UI_FLAG_HIDE_NAVIGATION für Interstitial-Anzeigen aktiviert, wenn dieses Flag aktiviert ist und der Immersive-Modus unterstützt wird.

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

Registriert einen Callback, der aufgerufen wird, wenn mit dieser Anzeige voraussichtlich Einnahmen erzielt wurden.

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

Legt eine Placement-ID für die Interstitial-Anzeige fest.

Damit diese Placement-ID in Berichte aufgenommen wird, rufen Sie diese Methode auf, bevor Sie die Anzeige präsentieren.

Parameter
placementId: Long

Eine lange Ganzzahl, die von der AdMob-Benutzeroberfläche für die konfigurierte Platzierung bereitgestellt wird.

Einblenden

abstract fun show(activity: Activity): Unit

Die Interstitial-Anzeige wird eingeblendet.

Parameter
activity: Activity

Ein Activity-Kontext, in dem die Anzeige präsentiert werden kann.