Aby omawiać nasze usługi i przekazywać opinie na ich temat, dołącz do oficjalnego kanału AdMob na Discordzie na serwerze społeczności Google Ads i pomiarów.

Ta strona została przetłumaczona przez Cloud Translation API.

InterstitialAd

Kotlin |Java

abstract class InterstitialAd

Znane bezpośrednie podklasy

AdManagerInterstitialAd

AdManagerInterstitialAd

Reklamy zajmujące całą stronę i wyświetlane w naturalnych momentach przejściowych, np. przy zmianie strony, uruchamianiu aplikacji lub wczytywaniu poziomu gry, w przypadku wydawców korzystających z Google Ad Managera.

Reklamy zajmujące całą stronę i wyświetlane w naturalnych momentach przejściowych, np. przy zmianie strony, uruchamianiu aplikacji lub wczytywaniu poziomu gry. Reklamy pełnoekranowe mają przycisk zamykania, który kończy ich wyświetlanie.

Przykładowy kod:

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

Podsumowanie

Publiczne konstruktory
`InterstitialAd()`

Funkcje publiczne
`abstract String`	`getAdUnitId()` Zwraca identyfikator jednostki reklamowej.
`abstract FullScreenContentCallback?`	`getFullScreenContentCallback()` Pobiera wartość `FullScreenContentCallback` dla tego elementu `InterstitialAd`.
`abstract OnPaidEventListener?`	`getOnPaidEventListener()` Pobiera wartość `OnPaidEventListener` dla tego elementu `InterstitialAd`.
`abstract Long`	`getPlacementId()` Zwraca identyfikator miejsca docelowego dla tego `InterstitialAd`.
`abstract ResponseInfo`	`getResponseInfo()` Zwraca obiekt `ResponseInfo` w przypadku wczytanej reklamy.
`java-static Boolean`	`isAdAvailable(context: Context, adUnitId: String)` Ta funkcja została wycofana. Zamiast niej użyj zasady `isAdAvailable`.
`java-static Unit`	`load( context: Context, adUnitId: String, adRequest: AdRequest, loadCallback: InterstitialAdLoadCallback )` Wczytuje `InterstitialAd`.
`java-static InterstitialAd?`	`pollAd(context: Context, adUnitId: String)` Ta funkcja została wycofana. Zamiast niej użyj zasady `pollAd`.
`abstract Unit`	`setFullScreenContentCallback( fullScreenContentCallback: FullScreenContentCallback? )` Rejestruje wywołanie zwrotne, które ma być wywoływane, gdy reklamy wyświetlają i zamykają treści pełnoekranowe.
`abstract Unit`	`setImmersiveMode(immersiveModeEnabled: Boolean)` Ustawia flagę, która określa, czy ten obiekt reklamy pełnoekranowej będzie wyświetlany w trybie immersyjnym.
`abstract Unit`	`setOnPaidEventListener(listener: OnPaidEventListener?)` Rejestruje wywołanie zwrotne, które ma zostać wywołane, gdy szacunkowe przychody z tej reklamy osiągną określony poziom.
`abstract Unit`	`setPlacementId(placementId: Long)` Ustawia identyfikator miejsca docelowego reklamy pełnoekranowej.
`abstract Unit`	`show(activity: Activity)` Wyświetla reklamę pełnoekranową.

Publiczne konstruktory

InterstitialAd

InterstitialAd()

Funkcje publiczne

getAdUnitId

abstract fun getAdUnitId(): String

Zwraca identyfikator jednostki reklamowej.

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

Pobiera wartość FullScreenContentCallback dla tego elementu InterstitialAd.

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

Pobiera wartość OnPaidEventListener dla tego elementu InterstitialAd.

getPlacementId

abstract fun getPlacementId(): Long

Zwraca identyfikator miejsca docelowego dla tego InterstitialAd.

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

Zwraca obiekt ResponseInfo w przypadku wczytanej reklamy. Zwraca wartość null, dopóki reklama nie zostanie wczytana.

isAdAvailable

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

Zwraca true, jeśli z startPreload została wczytana dostępna reklama pełnoekranowa.

ładunek

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

Wczytuje InterstitialAd.

Parametry
`context: Context`	kontekst aktywności lub aplikacji;
`adUnitId: String`	Identyfikator jednostki reklamowej.
`adRequest: AdRequest`	Żądanie reklamy z informacjami o kierowaniu.
`loadCallback: InterstitialAdLoadCallback`	Wywołanie zwrotne, które ma zostać wywołane po zakończeniu wczytywania reklamy pełnoekranowej.

pollAd

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

Pobiera kolejną reklamę pełnoekranową wczytaną z startPreload lub null, jeśli żadna reklama nie jest dostępna.

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

Rejestruje wywołanie zwrotne, które ma być wywoływane, gdy reklamy wyświetlają i zamykają treści pełnoekranowe.

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

Ustawia flagę, która określa, czy ten obiekt reklamy pełnoekranowej będzie wyświetlany w trybie immersyjnym. Wywołaj tę metodę przed show. Podczas show, jeśli ta flaga jest włączona i tryb pełnoekranowy jest obsługiwany, w przypadku reklamy pełnoekranowej włączone zostaną flagi SYSTEM_UI_FLAG_IMMERSIVE_STICKY i SYSTEM_UI_FLAG_HIDE_NAVIGATION.

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

Rejestruje wywołanie zwrotne, które ma zostać wywołane, gdy szacunkowe przychody z tej reklamy osiągną określony poziom.

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

Ustawia identyfikator miejsca docelowego reklamy pełnoekranowej.

Aby ten identyfikator miejsca docelowego był uwzględniany w raportach, wywołaj tę metodę przed wyświetleniem reklamy.

Parametry
`placementId: Long`	Długa liczba całkowita podana w interfejsie AdMob dla skonfigurowanego miejsca docelowego.

pokaż

abstract fun show(activity: Activity): Unit

Wyświetla reklamę pełnoekranową.

Parametry
`activity: Activity`	`Activity` kontekst, w którym ma się wyświetlać reklama;