InterstitialAd

Kotlin |Java

abstract class InterstitialAd

מחלקות משנה ישירות מוכרות

AdManagerInterstitialAd

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

סיכום

‫constructors ציבוריים
`InterstitialAd()`

פונקציות ציבוריות
`abstract String`	`getAdUnitId()` מחזירה את המזהה של יחידת המודעות.
`abstract FullScreenContentCallback?`	`getFullScreenContentCallback()` מחזירה את ה-`FullScreenContentCallback` של ה-`InterstitialAd` הזו.
`abstract OnPaidEventListener?`	`getOnPaidEventListener()` מחזירה את ה-`OnPaidEventListener` של ה-`InterstitialAd` הזו.
`abstract Long`	`getPlacementId()` מחזירה את מזהה מיקום המודעה של ה-`InterstitialAd` הזו.
`abstract ResponseInfo`	`getResponseInfo()` מחזירה את האובייקט `ResponseInfo` של המודעה שנטענה.
`java-static Boolean`	`isAdAvailable(context: Context, adUnitId: String)` הפונקציה הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-`isAdAvailable`.
`java-static Unit`	`load( context: Context, adUnitId: String, adRequest: AdRequest, loadCallback: InterstitialAdLoadCallback )` טוענת `InterstitialAd`.
`java-static InterstitialAd?`	`pollAd(context: Context, adUnitId: String)` הפונקציה הזו הוצאה משימוש. במקום זאת, אתם צריכים להשתמש ב-`pollAd`.
`abstract Unit`	`setFullScreenContentCallback( fullScreenContentCallback: FullScreenContentCallback? )` רושמת קריאה חוזרת (callback) שתופעל כשמודעות מוצגות ומבטלות תוכן במסך מלא.
`abstract Unit`	`setImmersiveMode(immersiveModeEnabled: Boolean)` מגדירה דגל שקובע אם אובייקט הביניים הזה יוצג במצב אימרסיבי.
`abstract Unit`	`setOnPaidEventListener(listener: OnPaidEventListener?)` רושמת קריאה חוזרת שתופעל כשהמערכת תעריך שהמודעה הזו הניבה רווחים.
`abstract Unit`	`setPlacementId(placementId: Long)` מגדירה מזהה מיקום למודעת המעברון.
`abstract Unit`	`show(activity: Activity)` מציגה את מודעת המעברון.

‫constructors ציבוריים

InterstitialAd

InterstitialAd()

פונקציות ציבוריות

getAdUnitId

abstract fun getAdUnitId(): String

מחזירה את המזהה של יחידת המודעות.

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

הפונקציה מחזירה את ה-FullScreenContentCallback של ה-InterstitialAd הזו.

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

הפונקציה מחזירה את ה-OnPaidEventListener של ה-InterstitialAd הזו.

getPlacementId

abstract fun getPlacementId(): Long

מחזירה את מזהה מיקום המודעה של ה-InterstitialAd הזו.

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

מחזירה את האובייקט ResponseInfo של המודעה שנטענה. מחזירה null עד שהמודעה נטענת בהצלחה.

isAdAvailable

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

מחזירה true אם יש מודעת מעברון זמינה שנטענה מ-startPreload.

load

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

טוענת InterstitialAd.

פרמטרים
`context: Context`	הקשר של פעילות או אפליקציה.
`adUnitId: String`	מזהה יחידת המודעות.
`adRequest: AdRequest`	בקשה להצגת מודעה עם פרטי טירגוט.
`loadCallback: InterstitialAdLoadCallback`	קריאה חוזרת (callback) שתופעל כשמודעת מעברון תסיים להיטען.

pollAd

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

מחזירה את מודעת המעברון הבאה שנטענה מ-startPreload, או מ-null אם אין מודעה זמינה.

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

רושמת קריאה חוזרת (callback) שתופעל כשמודעות מוצגות ומבטלות תוכן במסך מלא.

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

מגדירה דגל שקובע אם אובייקט הביניים הזה יוצג במצב אימרסיבי. צריך להפעיל את ה-method הזו לפני show. במהלך show, אם הדגל הזה מופעל ויש תמיכה במצב אימרסיבי, הדגלים SYSTEM_UI_FLAG_IMMERSIVE_STICKY ו-SYSTEM_UI_FLAG_HIDE_NAVIGATION יופעלו עבור מודעת המעברון.

setOnPaidEventListener

abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit

רושמת קריאה חוזרת שתופעל כשהמערכת תעריך שהמודעה הזו הניבה רווחים.

setPlacementId

abstract fun setPlacementId(placementId: Long): Unit

מגדירה מזהה מיקום למודעת המעברון.

כדי לוודא שמזהה מיקום המודעה הזה ייכלל בדוחות, צריך להפעיל את ה-method הזו לפני שמציגים את המודעה.

פרמטרים
`placementId: Long`	מספר שלם ארוך שמופיע בממשק המשתמש של AdMob למיקום המודעה שהוגדר.

show

abstract fun show(activity: Activity): Unit

מציגה את מודעת המעברון.

פרמטרים
`activity: Activity`	הקשר ה-`Activity` שבו המודעה תוצג.