InterstitialAd

Kotlin |Java

public abstract class InterstitialAd

Subclass langsung yang diketahui

AdManagerInterstitialAd

AdManagerInterstitialAd

Pengalaman iklan halaman penuh pada titik transisi alami seperti pergantian halaman, peluncuran aplikasi, atau pemuatan level game untuk penayang Google Ad Manager.

Pengalaman iklan halaman penuh pada titik transisi alami seperti pergantian halaman, peluncuran aplikasi, atau pemuatan level game. Iklan interstisial menggunakan tombol tutup yang menghapus iklan dari pengalaman pengguna.

Contoh kode:

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

Ringkasan

Konstruktor publik
`InterstitialAd()`

Metode publik
`abstract @NonNull String`	`getAdUnitId()` Menampilkan ID unit iklan.
`abstract @Nullable FullScreenContentCallback`	`getFullScreenContentCallback()` Mendapatkan `FullScreenContentCallback` untuk `InterstitialAd` ini.
`abstract @Nullable OnPaidEventListener`	`getOnPaidEventListener()` Mendapatkan `OnPaidEventListener` untuk `InterstitialAd` ini.
`abstract long`	`getPlacementId()` Menampilkan ID penempatan untuk `InterstitialAd` ini.
`abstract @NonNull ResponseInfo`	`getResponseInfo()` Menampilkan objek `ResponseInfo` untuk iklan yang dimuat.
`static boolean`	`isAdAvailable(@NonNull Context context, @NonNull String adUnitId)` Metode ini tidak digunakan lagi. Sebagai gantinya, gunakan `isAdAvailable`.
`static void`	`load( @NonNull Context context, @NonNull String adUnitId, @NonNull AdRequest adRequest, @NonNull InterstitialAdLoadCallback loadCallback )` Memuat `InterstitialAd`.
`static @Nullable InterstitialAd`	`pollAd(@NonNull Context context, @NonNull String adUnitId)` Metode ini tidak digunakan lagi. Sebagai gantinya, gunakan `pollAd`.
`abstract void`	`setFullScreenContentCallback( @Nullable FullScreenContentCallback fullScreenContentCallback )` Mendaftarkan callback untuk dipanggil saat iklan menampilkan dan menutup konten layar penuh.
`abstract void`	`setImmersiveMode(boolean immersiveModeEnabled)` Menetapkan tanda yang mengontrol apakah objek interstisial ini akan ditampilkan dalam mode imersif.
`abstract void`	`setOnPaidEventListener(@Nullable OnPaidEventListener listener)` Mendaftarkan callback untuk dipanggil saat iklan ini diperkirakan telah menghasilkan uang.
`abstract void`	`setPlacementId(long placementId)` Menetapkan ID penempatan untuk iklan interstisial.
`abstract void`	`show(@NonNull Activity activity)` Menampilkan iklan interstisial.

Konstruktor publik

InterstitialAd

public InterstitialAd()

Metode publik

getAdUnitId

public abstract @NonNull String getAdUnitId()

Menampilkan ID unit iklan.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

Mendapatkan FullScreenContentCallback untuk InterstitialAd ini.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

Mendapatkan OnPaidEventListener untuk InterstitialAd ini.

getPlacementId

public abstract long getPlacementId()

Menampilkan ID penempatan untuk InterstitialAd ini.

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

Menampilkan objek ResponseInfo untuk iklan yang dimuat. Menampilkan null hingga iklan berhasil dimuat.

isAdAvailable

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

Menampilkan true jika ada iklan interstisial yang tersedia dan dimuat dari startPreload.

load

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

Memuat InterstitialAd.

Parameter
`@NonNull Context context`	Konteks aktivitas atau aplikasi.
`@NonNull String adUnitId`	ID unit iklan.
`@NonNull AdRequest adRequest`	Permintaan iklan dengan informasi penargetan.
`@NonNull InterstitialAdLoadCallback loadCallback`	Callback yang akan dipanggil saat iklan interstisial selesai dimuat.

pollAd

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

Mengambil iklan interstisial berikutnya yang dimuat dari startPreload, atau null jika tidak ada iklan yang tersedia.

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

Mendaftarkan callback untuk dipanggil saat iklan menampilkan dan menutup konten layar penuh.

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

Menetapkan tanda yang mengontrol apakah objek interstisial ini akan ditampilkan dalam mode imersif. Panggil metode ini sebelum show. Selama show, jika tanda ini aktif dan mode imersif didukung, SYSTEM_UI_FLAG_IMMERSIVE_STICKY & SYSTEM_UI_FLAG_HIDE_NAVIGATION akan diaktifkan untuk iklan interstisial.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

Mendaftarkan callback untuk dipanggil saat iklan ini diperkirakan telah menghasilkan uang.

setPlacementId

public abstract void setPlacementId(long placementId)

Menetapkan ID penempatan untuk iklan interstisial.

Untuk memastikan ID penempatan ini disertakan dalam pelaporan, panggil metode ini sebelum menampilkan iklan.

Parameter
`long placementId`	Bilangan bulat panjang yang disediakan oleh UI AdMob untuk penempatan yang dikonfigurasi.

tunjukkan

public abstract void show(@NonNull Activity activity)

Menampilkan iklan interstisial.

Parameter
`@NonNull Activity activity`	Konteks `Activity` dari mana iklan akan ditampilkan.