InterstitialAd

public abstract class InterstitialAd

Znane bezpośrednie podklasy
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

Konstruktory publiczne

Metody publiczne

abstract @NonNull String

Zwraca identyfikator jednostki reklamowej.

abstract @Nullable FullScreenContentCallback

Pobiera FullScreenContentCallback dla tego InterstitialAd.

abstract @Nullable OnPaidEventListener

Pobiera OnPaidEventListener dla tego InterstitialAd.

abstract long

Zwraca identyfikator miejsca docelowego dla tego InterstitialAd.

abstract @NonNull ResponseInfo

Zwraca obiekt ResponseInfo wczytanej reklamy.

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

Ta metoda została wycofana.

Zamiast tego użyj metody isAdAvailable.

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

Wczytuje InterstitialAd.

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

Ta metoda została wycofana.

Zamiast niej użyj funkcji pollAd.

abstract void

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

abstract void
setImmersiveMode(boolean immersiveModeEnabled)

Ustawia flagę, która określa, czy ten obiekt reklamy pełnoekranowej będzie wyświetlany w trybie immersyjnym.

abstract void

Rejestruje wywołanie zwrotne, które ma zostać wywołane, gdy ta reklama wygeneruje szacunkowe przychody.

abstract void
setPlacementId(long placementId)

Ustawia identyfikator miejsca docelowego reklamy pełnoekranowej.

abstract void
show(@NonNull Activity activity)

Wyświetla reklamę pełnoekranową.

Konstruktory publiczne

InterstitialAd

public InterstitialAd()

Metody publiczne

getAdUnitId

public abstract @NonNull String getAdUnitId()

Zwraca identyfikator jednostki reklamowej.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

Pobiera FullScreenContentCallback dla tego InterstitialAd.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Pobiera OnPaidEventListener dla tego InterstitialAd.

getPlacementId

public abstract long getPlacementId()

Zwraca identyfikator miejsca docelowego dla tego InterstitialAd.

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

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

isAdAvailable

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

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

ładunek

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

Wczytuje InterstitialAd.

Parametry
@NonNull Context context

kontekst aktywności lub aplikacji.

@NonNull String adUnitId

Identyfikator jednostki reklamowej.

@NonNull AdRequest adRequest

Żądanie reklamy z informacjami o kierowaniu.

@NonNull InterstitialAdLoadCallback loadCallback

Wywołanie zwrotne, które ma zostać wywołane po zakończeniu wczytywania reklamy pełnoekranowej.

pollAd

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

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

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

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

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

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

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

Rejestruje wywołanie zwrotne, które ma zostać wywołane, gdy ta reklama wygeneruje szacunkowe przychody.

setPlacementId

public abstract void setPlacementId(long placementId)

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

Długa liczba całkowita podana w interfejsie AdMob dla skonfigurowanego miejsca docelowego.

pokaż

public abstract void show(@NonNull Activity activity)

Wyświetla reklamę pełnoekranową.

Parametry
@NonNull Activity activity

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