تبلیغات بینابینی

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

خلاصه

سازندگان عمومی

روش‌های عمومی

abstract @ NonNull String

شناسه واحد تبلیغ را برمی‌گرداند.

abstract @ Nullable FullScreenContentCallback

برای این InterstitialAd مقدار FullScreenContentCallback را دریافت می‌کند.

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)

پرچمی را تنظیم می‌کند که کنترل می‌کند آیا این شیء بینابینی در حالت فراگیر نمایش داده شود یا خیر.

abstract void

یک تابع فراخوانی ثبت می‌کند تا زمانی که تخمین زده شود این تبلیغ درآمد کسب کرده است، فراخوانی شود.

abstract void
setPlacementId (long placementId)

یک شناسه قرارگیری برای تبلیغ بینابینی تنظیم می‌کند.

abstract void
show (@ NonNull Activity activity)

تبلیغ بینابینی را نشان می‌دهد.

سازندگان عمومی

تبلیغات بینابینی

public InterstitialAd()

روش‌های عمومی

دریافت شناسه واحد تبلیغات

public abstract @NonNull String getAdUnitId()

شناسه واحد تبلیغ را برمی‌گرداند.

فراخوانی برگشتی محتوای تمام‌صفحه

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

برای این InterstitialAd مقدار FullScreenContentCallback را دریافت می‌کند.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

OnPaidEventListener برای این InterstitialAd دریافت می‌کند.

دریافت شناسه‌ی مکان

public abstract long getPlacementId()

شناسه قرارگیری برای این InterstitialAd را برمی‌گرداند.

دریافت اطلاعات پاسخ

public abstract @NonNull ResponseInfo getResponseInfo()

شیء ResponseInfo را برای تبلیغ بارگذاری شده برمی‌گرداند. تا زمانی که تبلیغ با موفقیت بارگذاری نشود، null را برمی‌گرداند.

موجود است

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

اگر یک تبلیغ بینابینی از startPreload بارگذاری شده باشد، true را برمی‌گرداند.

بار

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

یک فراخوانی برگشتی که پس از اتمام بارگذاری یک تبلیغ بینابینی فراخوانی می‌شود.

نظرسنجی

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

تبلیغ بینابینی بعدی که از startPreload بارگذاری شده است را بازیابی می‌کند، یا اگر تبلیغی در دسترس نباشد null برمی‌گرداند.

فراخوانی برگشتی محتوای تمام‌صفحه

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

یک فراخوانی مجدد ثبت می‌کند تا هنگام نمایش و رد محتوای تمام صفحه توسط تبلیغات، فراخوانی شود.

حالت فراگیر (ImmersiveMode) را تنظیم کنید

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

یک پرچم تنظیم می‌کند که کنترل می‌کند آیا این شیء بینابینی در حالت فراگیر نمایش داده شود یا خیر. این متد را قبل از show فراخوانی کنید. در طول show ، اگر این پرچم فعال باشد و حالت فراگیر پشتیبانی شود، SYSTEM_UI_FLAG_IMMERSIVE_STICKY و SYSTEM_UI_FLAG_HIDE_NAVIGATION برای تبلیغ بینابینی فعال خواهند شد.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

یک تابع فراخوانی ثبت می‌کند تا زمانی که تخمین زده شود این تبلیغ درآمد کسب کرده است، فراخوانی شود.

شناسه‌ی جایگذاری را تنظیم کنید

public abstract void setPlacementId(long placementId)

یک شناسه قرارگیری برای تبلیغ بینابینی تنظیم می‌کند.

برای اطمینان از اینکه این شناسه‌ی قرارگیری در گزارش‌دهی لحاظ شده است، قبل از نمایش تبلیغ، این متد را فراخوانی کنید.

پارامترها
long placementId

یک عدد صحیح طولانی که توسط رابط کاربری AdMob برای مکان‌یابی پیکربندی‌شده ارائه شده است.

نشان دادن

public abstract void show(@NonNull Activity activity)

تبلیغ بینابینی را نشان می‌دهد.

پارامترها
@ NonNull Activity activity

یک زمینه Activity که از آن می‌توان تبلیغ را ارائه داد.