InterstitialAd

abstract class InterstitialAd

Subclass langsung yang diketahui
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

Fungsi publik
abstract String

Menampilkan ID unit iklan.
abstract FullScreenContentCallback?

Mendapatkan FullScreenContentCallback untuk InterstitialAd ini.
abstract OnPaidEventListener?

Mendapatkan OnPaidEventListener untuk InterstitialAd ini.
abstract Long

Menampilkan ID penempatan untuk InterstitialAd ini.
abstract ResponseInfo

Menampilkan objek ResponseInfo untuk iklan yang dimuat.
java-static Boolean
isAdAvailable(context: Context, adUnitId: String)

Fungsi ini tidak digunakan lagi.

Sebagai gantinya, gunakan isAdAvailable.
java-static Unit
load(
    context: Context,
    adUnitId: String,
    adRequest: AdRequest,
    loadCallback: InterstitialAdLoadCallback
)

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

Fungsi ini tidak digunakan lagi.

Gunakan pollAd sebagai gantinya.
abstract Unit
setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
)

Mendaftarkan callback untuk dipanggil saat iklan menampilkan dan menutup konten layar penuh.
abstract Unit
setImmersiveMode(immersiveModeEnabled: Boolean)

Menetapkan tanda yang mengontrol apakah objek interstisial ini akan ditampilkan dalam mode imersif.
abstract Unit

Mendaftarkan callback untuk dipanggil saat iklan ini diperkirakan telah menghasilkan uang.
abstract Unit
setPlacementId(placementId: Long)

Menetapkan ID penempatan untuk iklan interstisial.
abstract Unit
show(activity: Activity)

Menampilkan iklan interstisial.

Konstruktor publik

InterstitialAd

InterstitialAd()

Fungsi publik

getAdUnitId

abstract fun getAdUnitId(): String

Menampilkan ID unit iklan.

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

Mendapatkan FullScreenContentCallback untuk InterstitialAd ini.

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

Mendapatkan OnPaidEventListener untuk InterstitialAd ini.

getPlacementId

abstract fun getPlacementId(): Long

Menampilkan ID penempatan untuk InterstitialAd ini.

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

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

isAdAvailable

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

Menampilkan true jika ada iklan interstisial yang dimuat dari startPreload.

load

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

Memuat InterstitialAd.

Parameter
context: Context

Konteks aktivitas atau aplikasi.
adUnitId: String

ID unit iklan.
adRequest: AdRequest

Permintaan iklan dengan informasi penargetan.
loadCallback: InterstitialAdLoadCallback

Callback yang akan dipanggil saat iklan interstisial selesai dimuat.

pollAd

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

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

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

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

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

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

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

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

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

Menetapkan ID penempatan untuk iklan interstisial.

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

Parameter
placementId: Long

Bilangan bulat panjang yang disediakan oleh UI AdMob untuk penempatan yang dikonfigurasi.

tunjukkan

abstract fun show(activity: Activity): Unit

Menampilkan iklan interstisial.

Parameter
activity: Activity

Konteks Activity tempat iklan akan ditampilkan.