InterstitialAd

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

abstract @NonNull String

Gibt die Anzeigenblock-ID zurück.

abstract @Nullable FullScreenContentCallback

Ruft die FullScreenContentCallback für diese InterstitialAd ab.

abstract @Nullable OnPaidEventListener

Ruft die OnPaidEventListener für diese InterstitialAd ab.

abstract long

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

abstract @NonNull ResponseInfo

Gibt das ResponseInfo-Objekt für die geladene Anzeige zurück.

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

Diese Methode wurde eingestellt.

Verwenden Sie stattdessen isAdAvailable.

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

Lädt ein InterstitialAd.

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

Diese Methode wurde eingestellt.

Verwenden Sie stattdessen „pollAd“.

abstract void

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

abstract void
setImmersiveMode(boolean immersiveModeEnabled)

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

abstract void

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

abstract void
setPlacementId(long placementId)

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

abstract void
show(@NonNull Activity activity)

Die Interstitial-Anzeige wird eingeblendet.

Öffentliche Konstruktoren

InterstitialAd

public InterstitialAd()

Öffentliche Methoden

getAdUnitId

public abstract @NonNull String getAdUnitId()

Gibt die Anzeigenblock-ID zurück.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

Ruft die FullScreenContentCallback für diese InterstitialAd ab.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Ruft die OnPaidEventListener für diese InterstitialAd ab.

getPlacementId

public abstract long getPlacementId()

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

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

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

isAdAvailable

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

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

load

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

Lädt ein InterstitialAd.

Parameter
@NonNull Context context

Ein Aktivitäts- oder Anwendungskontext.

@NonNull String adUnitId

Die Anzeigenblock-ID.

@NonNull AdRequest adRequest

Eine Anzeigenanfrage mit Targeting-Informationen.

@NonNull InterstitialAdLoadCallback loadCallback

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

pollAd

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

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

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

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

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

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

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

setPlacementId

public abstract void setPlacementId(long placementId)

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

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

Einblenden

public abstract void show(@NonNull Activity activity)

Die Interstitial-Anzeige wird eingeblendet.

Parameter
@NonNull Activity activity

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