InterstitialAd

abstract class InterstitialAd

Các lớp con trực tiếp đã biết
AdManagerInterstitialAd

Trải nghiệm quảng cáo toàn trang ở các điểm chuyển tiếp tự nhiên, chẳng hạn như chuyển trang, khởi động ứng dụng hoặc tải cấp độ trò chơi cho nhà xuất bản Google Ad Manager.

Trải nghiệm quảng cáo toàn trang ở các điểm chuyển tiếp tự nhiên, chẳng hạn như chuyển trang, khởi động ứng dụng hoặc tải cấp độ trò chơi. Quảng cáo xen kẽ sử dụng nút đóng để xoá quảng cáo khỏi trải nghiệm của người dùng.

Mã mẫu: 

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

Tóm tắt

Hàm khởi tạo công khai

Hàm công khai
abstract String

Trả về mã đơn vị quảng cáo.
abstract FullScreenContentCallback?

Lấy FullScreenContentCallback cho InterstitialAd này.
abstract OnPaidEventListener?

Lấy OnPaidEventListener cho InterstitialAd này.
abstract Long

Trả về mã vị trí cho InterstitialAd này.
abstract ResponseInfo

Trả về đối tượng ResponseInfo cho quảng cáo đã tải.
java-static Boolean
isAdAvailable(context: Context, adUnitId: String)

Hàm này không còn được dùng nữa.

Thay vào đó, hãy sử dụng isAdAvailable.
java-static Unit
load(
    context: Context,
    adUnitId: String,
    adRequest: AdRequest,
    loadCallback: InterstitialAdLoadCallback
)

Tải một InterstitialAd.
java-static InterstitialAd?
pollAd(context: Context, adUnitId: String)

Hàm này không còn được dùng nữa.

Thay vào đó, hãy sử dụng pollAd.
abstract Unit
setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
)

Đăng ký một lệnh gọi lại sẽ được gọi khi quảng cáo hiển thị và loại bỏ nội dung toàn màn hình.
abstract Unit
setImmersiveMode(immersiveModeEnabled: Boolean)

Đặt một cờ kiểm soát việc đối tượng quảng cáo xen kẽ này sẽ xuất hiện ở chế độ sống động hay không.
abstract Unit

Đăng ký một lệnh gọi lại sẽ được gọi khi quảng cáo này được ước tính là đã kiếm được tiền.
abstract Unit
setPlacementId(placementId: Long)

Đặt mã vị trí cho quảng cáo xen kẽ.
abstract Unit
show(activity: Activity)

Hiển thị quảng cáo xen kẽ.

Hàm khởi tạo công khai

InterstitialAd

InterstitialAd()

Hàm công khai

getAdUnitId

abstract fun getAdUnitId(): String

Trả về mã đơn vị quảng cáo.

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

Lấy FullScreenContentCallback cho InterstitialAd này.

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

Lấy OnPaidEventListener cho InterstitialAd này.

getPlacementId

abstract fun getPlacementId(): Long

Trả về mã vị trí cho InterstitialAd này.

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

Trả về đối tượng ResponseInfo cho quảng cáo đã tải. Trả về null cho đến khi quảng cáo tải thành công.

isAdAvailable

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

Trả về true nếu có quảng cáo xen kẽ hiện có được tải từ startPreload.

trọng tải

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

Tải một InterstitialAd.

Thông số
context: Context

Ngữ cảnh hoạt động hoặc ứng dụng.
adUnitId: String

Mã đơn vị quảng cáo.
adRequest: AdRequest

Yêu cầu quảng cáo có thông tin nhắm mục tiêu.
loadCallback: InterstitialAdLoadCallback

Một lệnh gọi lại sẽ được gọi khi quảng cáo xen kẽ tải xong.

pollAd

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

Truy xuất quảng cáo xen kẽ tiếp theo được tải từ startPreload hoặc null nếu không có quảng cáo.

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

Đăng ký một lệnh gọi lại sẽ được gọi khi quảng cáo hiển thị và loại bỏ nội dung toàn màn hình.

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

Đặt một cờ kiểm soát việc đối tượng quảng cáo xen kẽ này sẽ xuất hiện ở chế độ sống động hay không. Gọi phương thức này trước show. Trong show, nếu cờ này đang bật và chế độ chìm được hỗ trợ, thì SYSTEM_UI_FLAG_IMMERSIVE_STICKY và SYSTEM_UI_FLAG_HIDE_NAVIGATION sẽ bật cho quảng cáo xen kẽ.

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

Đăng ký một lệnh gọi lại sẽ được gọi khi quảng cáo này được ước tính là đã kiếm được tiền.

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

Đặt mã vị trí cho quảng cáo xen kẽ.

Để đảm bảo mã vị trí này được đưa vào báo cáo, hãy gọi phương thức này trước khi hiển thị quảng cáo.

Thông số
placementId: Long

Một số nguyên dài do giao diện người dùng AdMob cung cấp cho vị trí đã định cấu hình.

hiện (lên)/cho thấy

abstract fun show(activity: Activity): Unit

Hiển thị quảng cáo xen kẽ.

Thông số
activity: Activity

Ngữ cảnh Activity để hiển thị quảng cáo.