InterstitialAd

public abstract class InterstitialAd

คลาสย่อยโดยตรงที่ทราบ
AdManagerInterstitialAd

ประสบการณ์การใช้งานโฆษณาเต็มหน้าที่แสดงที่จุดเปลี่ยนตามปกติ เช่น การเปลี่ยนหน้าเว็บ การเปิดแอป หรือการโหลดระดับเกมสำหรับผู้เผยแพร่โฆษณา Google Ad Manager


ประสบการณ์การใช้งานโฆษณาเต็มหน้าที่แสดงที่จุดเปลี่ยนตามปกติ เช่น การเปลี่ยนหน้าเว็บ การเปิดแอป หรือการโหลดระดับเกม โฆษณาคั่นระหว่างหน้าใช้ปุ่มปิดเพื่อให้ผู้ใช้นำโฆษณาออกได้

โค้ดตัวอย่าง

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

สรุป

เครื่องมือสร้างสาธารณะ

เมธอดสาธารณะ

abstract @NonNull String

แสดงรหัสหน่วยโฆษณา

abstract @Nullable FullScreenContentCallback

รับ FullScreenContentCallback สำหรับ InterstitialAd นี้

abstract @Nullable OnPaidEventListener

รับ OnPaidEventListener สำหรับ InterstitialAd นี้

abstract long

แสดงรหัสตำแหน่งโฆษณาสำหรับ InterstitialAd นี้

abstract @NonNull ResponseInfo

แสดงผลออบเจ็กต์ ResponseInfo สำหรับโฆษณาที่โหลดแล้ว

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

เลิกใช้เมธอดนี้แล้ว

โปรดใช้ isAdAvailable แทน

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

โหลด InterstitialAd

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

เลิกใช้เมธอดนี้แล้ว

โปรดใช้ pollAd แทน

abstract void

ลงทะเบียนการเรียกกลับที่จะเรียกใช้เมื่อโฆษณาแสดงและปิดเนื้อหาแบบเต็มหน้าจอ

abstract void
setImmersiveMode(boolean immersiveModeEnabled)

ตั้งค่า Flag ที่ควบคุมว่าจะแสดงออบเจ็กต์โฆษณาคั่นระหว่างหน้าในโหมดสมจริงหรือไม่

abstract void

ลงทะเบียน Callback ที่จะเรียกใช้เมื่อระบบประเมินว่าโฆษณานี้สร้างรายได้

abstract void
setPlacementId(long placementId)

ตั้งรหัสตําแหน่งสําหรับโฆษณาคั่นระหว่างหน้า

abstract void
show(@NonNull Activity activity)

แสดงโฆษณาคั่นระหว่างหน้า

เครื่องมือสร้างสาธารณะ

InterstitialAd

public InterstitialAd()

เมธอดสาธารณะ

getAdUnitId

public abstract @NonNull String getAdUnitId()

แสดงรหัสหน่วยโฆษณา

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

รับ FullScreenContentCallback สำหรับ InterstitialAd นี้

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

รับ OnPaidEventListener สำหรับ InterstitialAd นี้

getPlacementId

public abstract long getPlacementId()

แสดงรหัสตำแหน่งโฆษณาสำหรับ InterstitialAd นี้

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

แสดงผลออบเจ็กต์ ResponseInfo สำหรับโฆษณาที่โหลดแล้ว แสดงผล null จนกว่าโฆษณาจะโหลดสําเร็จ

isAdAvailable

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

แสดงผล true หากมีโฆษณาคั่นระหว่างหน้าที่โหลดจาก startPreload

โหลด

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

โหลด InterstitialAd

พารามิเตอร์
@NonNull Context context

บริบทของกิจกรรมหรือแอปพลิเคชัน

@NonNull String adUnitId

รหัสหน่วยโฆษณา

@NonNull AdRequest adRequest

คำขอโฆษณาที่มีข้อมูลการกำหนดเป้าหมาย

@NonNull InterstitialAdLoadCallback loadCallback

Callback ที่จะเรียกใช้เมื่อโฆษณาคั่นระหว่างหน้าโหลดเสร็จ

pollAd

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

เรียกโฆษณาคั่นระหว่างหน้าที่โหลดถัดไปจาก startPreload หรือ null หากไม่มีโฆษณา

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

ลงทะเบียนการเรียกกลับที่จะเรียกใช้เมื่อโฆษณาแสดงและปิดเนื้อหาแบบเต็มหน้าจอ

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

ตั้งค่า Flag ที่ควบคุมว่าจะแสดงออบเจ็กต์โฆษณาคั่นระหว่างหน้าในโหมดสมจริงหรือไม่ เรียกใช้เมธอดนี้ก่อนวันที่ show ในระหว่าง show หากเปิดแฟล็กนี้และรองรับโหมดสมจริง ระบบจะเปิด SYSTEM_UI_FLAG_IMMERSIVE_STICKY และ SYSTEM_UI_FLAG_HIDE_NAVIGATION สำหรับโฆษณาคั่นระหว่างหน้า

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

ลงทะเบียน Callback ที่จะเรียกใช้เมื่อระบบประเมินว่าโฆษณานี้สร้างรายได้

setPlacementId

public abstract void setPlacementId(long placementId)

ตั้งรหัสตําแหน่งสําหรับโฆษณาคั่นระหว่างหน้า

เรียกใช้เมธอดนี้ก่อนแสดงโฆษณาเพื่อให้มั่นใจว่าระบบจะรวมรหัสตำแหน่งนี้ไว้ในการรายงาน

พารามิเตอร์
long placementId

จำนวนเต็มแบบยาวที่ AdMob UI ระบุสำหรับตําแหน่งที่กําหนดค่า

แสดง

public abstract void show(@NonNull Activity activity)

แสดงโฆษณาคั่นระหว่างหน้า

พารามิเตอร์
@NonNull Activity activity

Activity บริบทที่จะใช้แสดงโฆษณา