تبلیغات بینابینی پاداش‌دار

کاتلین | جاوا

public abstract class RewardedInterstitialAd

---

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

This ad format is different than com.google.android.gms.ads.rewarded.RewardedAd because rewarded ads require the user to opt-in to watching the video. This ad format is different than com.google.android.gms.ads.interstitial.InterstitialAd because interstitial ads do not reward the user.

خلاصه

سازندگان عمومی
RewardedInterstitialAd ()

روش‌های عمومی
abstract @ NonNull Bundle	getAdMetadata () تمام ابرداده‌های تبلیغ موجود برای این RewardedInterstitialAd را دریافت می‌کند.
abstract @ NonNull String	getAdUnitId () شناسه واحد تبلیغ را برمی‌گرداند.
abstract @ Nullable FullScreenContentCallback	getFullScreenContentCallback () برای این RewardedInterstitialAd مقدار FullScreenContentCallback را دریافت می‌کند.
abstract @ Nullable OnAdMetadataChangedListener	getOnAdMetadataChangedListener () OnAdMetadataChangedListener برای این RewardedInterstitialAd دریافت می‌کند.
abstract @ Nullable OnPaidEventListener	getOnPaidEventListener () OnPaidEventListener برای این RewardedInterstitialAd دریافت می‌کند.
abstract long	getPlacementId () شناسه‌ی قرارگیری را برای این RewardedInterstitialAd دریافت می‌کند.
abstract @ NonNull ResponseInfo	getResponseInfo () اطلاعات مربوط به تبلیغ بارگذاری شده را برمی‌گرداند.
abstract @ NonNull RewardItem	getRewardItem () برای تبلیغ بینابینیِ دارای پاداشِ بارگذاری‌شده، یک آیتم پاداش دریافت می‌کند.
static void	load ( @ NonNull Context context, @ NonNull String adUnitId, @ NonNull AdManagerAdRequest adManagerAdRequest, @ NonNull RewardedInterstitialAdLoadCallback loadCallback ) یک RewardedInterstitialAd بارگذاری می‌کند.
static void	load ( @ NonNull Context context, @ NonNull String adUnitId, @ NonNull AdRequest adRequest, @ NonNull RewardedInterstitialAdLoadCallback loadCallback ) یک RewardedInterstitialAd بارگذاری می‌کند.
abstract void	setFullScreenContentCallback ( @ Nullable FullScreenContentCallback fullScreenContentCallback ) یک فراخوانی مجدد ثبت می‌کند تا هنگام نمایش و رد محتوای تمام صفحه توسط تبلیغات، فراخوانی شود.
abstract void	setImmersiveMode (boolean immersiveModeEnabled) پرچمی را تنظیم می‌کند که کنترل می‌کند آیا این شیء تبلیغاتی بینابینیِ پاداش‌دار در حالت فراگیر نمایش داده شود یا خیر.
abstract void	setOnAdMetadataChangedListener ( @ Nullable OnAdMetadataChangedListener listener ) یک تابع فراخوانی ثبت می‌کند تا در صورت تغییر متادیتای تبلیغ بینابینیِ پاداش‌دار، فراخوانی شود.
abstract void	setOnPaidEventListener (@ Nullable OnPaidEventListener listener) یک تابع فراخوانی ثبت می‌کند تا زمانی که تخمین زده شود این تبلیغ درآمد کسب کرده است، فراخوانی شود.
abstract void	setPlacementId (long placementId) یک شناسه قرارگیری برای تبلیغ بینابینی جایزه‌دار تنظیم می‌کند.
abstract void	setServerSideVerificationOptions ( ServerSideVerificationOptions options ) گزینه‌های تأیید سمت ServerSideVerificationOptions را برای این تبلیغ بینابینیِ پاداش‌دار تنظیم می‌کند.
abstract void	show ( @ NonNull Activity activity, @ NonNull OnUserEarnedRewardListener onUserEarnedRewardListener ) تبلیغ بینابینی جایزه‌دار را نشان می‌دهد.

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

تبلیغات بینابینی پاداش‌دار

public RewardedInterstitialAd()

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

دریافت فراداده Ad

public abstract @NonNull Bundle getAdMetadata()

تمام فراداده‌های تبلیغ موجود برای این RewardedInterstitialAd را دریافت می‌کند. اگر تبلیغ فراداده نداشته باشد، فراداده تبلیغ خالی است. فراداده تبلیغ ممکن است به‌روزرسانی شود. برای دریافت تغییرات onAdMetadataChanged استفاده کنید.

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

public abstract @NonNull String getAdUnitId()

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

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

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

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

getOnAdMetadataChangedListener

public abstract @Nullable OnAdMetadataChangedListener getOnAdMetadataChangedListener()

OnAdMetadataChangedListener برای این RewardedInterstitialAd دریافت می‌کند.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

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

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

public abstract long getPlacementId()

شناسه‌ی قرارگیری را برای این RewardedInterstitialAd دریافت می‌کند.

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

public abstract @NonNull ResponseInfo getResponseInfo()

اطلاعات مربوط به تبلیغ بارگذاری شده را برمی‌گرداند.

دریافت آیتم پاداش

public abstract @NonNull RewardItem getRewardItem()

برای تبلیغ بینابینیِ دارای پاداشِ بارگذاری‌شده، یک آیتم پاداش دریافت می‌کند.

بار

public static void load(
    @NonNull Context context,
    @NonNull String adUnitId,
    @NonNull AdManagerAdRequest adManagerAdRequest,
    @NonNull RewardedInterstitialAdLoadCallback loadCallback
)

یک RewardedInterstitialAd بارگذاری می‌کند.

پارامترها
@ NonNull Context context	زمینه.
@ NonNull String adUnitId	شناسه واحد تبلیغاتی.
@ NonNull AdManagerAdRequest adManagerAdRequest	درخواست تبلیغ Google Ad Manager به همراه اطلاعات هدف‌گیری.
@ NonNull RewardedInterstitialAdLoadCallback loadCallback	فراخوانی که پس از اتمام بارگذاری یک تبلیغ بینابینی پاداش‌دار، فراخوانی می‌شود.

بار

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

یک RewardedInterstitialAd بارگذاری می‌کند.

پارامترها
@ NonNull Context context	زمینه.
@ NonNull String adUnitId	شناسه واحد تبلیغاتی.
@ NonNull AdRequest adRequest	درخواست تبلیغ به همراه اطلاعات هدف‌گیری.
@ NonNull RewardedInterstitialAdLoadCallback loadCallback	فراخوانی که پس از اتمام بارگذاری یک تبلیغ بینابینی پاداش‌دار، فراخوانی می‌شود.

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

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

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

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

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

Sets a flag that controls if this rewarded interstitial ad object will be displayed in immersive mode. Call this method before show . During show , if this flag is on and immersive mode is supported, SYSTEM_UI_FLAG_IMMERSIVE_STICKY &SYSTEM_UI_FLAG_HIDE_NAVIGATION will be turned on for the rewarded ad.

setOnAdMetadataChangedListener

public abstract void setOnAdMetadataChangedListener(
    @Nullable OnAdMetadataChangedListener listener
)

یک تابع فراخوانی ثبت می‌کند تا در صورت تغییر متادیتای تبلیغ بینابینیِ پاداش‌دار، فراخوانی شود.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

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

public abstract void setPlacementId(long placementId)

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

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

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

گزینه‌های تأیید سمت سرور را تنظیم کنید

public abstract void setServerSideVerificationOptions(
    ServerSideVerificationOptions options
)

گزینه‌های تأیید سمت ServerSideVerificationOptions را برای این تبلیغ بینابینیِ پاداش‌دار تنظیم می‌کند.

نشان دادن

public abstract void show(
    @NonNull Activity activity,
    @NonNull OnUserEarnedRewardListener onUserEarnedRewardListener
)

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

پارامترها
@ NonNull Activity activity	فعالیتی که باید از آن تبلیغ جایزه‌دار نمایش داده شود.
@ NonNull OnUserEarnedRewardListener onUserEarnedRewardListener	شنونده‌ای که وقتی کاربر پاداشی کسب می‌کند، مطلع می‌شود.