RewardedInterstitialAd

Kotlin |Java

public abstract class RewardedInterstitialAd

---

"الإعلانات البينية مقابل مكافأة" هي إعلانات بملء الشاشة تكافئ المستخدمين ويمكن عرضها بدون موافقة المستخدم.

يختلف شكل الإعلان هذا عن com.google.android.gms.ads.rewarded.RewardedAd لأنّ "الإعلانات مقابل مكافأة" تتطلّب موافقة المستخدم على مشاهدة الفيديو. يختلف شكل الإعلان هذا عن com.google.android.gms.ads.interstitial.InterstitialAd لأنّ الإعلانات البينية لا تقدّم مكافأة للمستخدم.

ملخّص

الدوال الإنشائية العامة
RewardedInterstitialAd()

الطُرق العامة
abstract @NonNull Bundle	getAdMetadata() تعرض هذه السمة جميع البيانات الوصفية المتاحة للإعلان الخاص بـ RewardedInterstitialAd.
abstract @NonNull String	getAdUnitId() تعرِض هذه السمة رقم تعريف الوحدة الإعلانية.
abstract @Nullable FullScreenContentCallback	getFullScreenContentCallback() تعرض هذه السمة FullScreenContentCallback الخاص بـ RewardedInterstitialAd.
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 ) تعرِض هذه السمة الإعلان البيني الذي يضمّ مكافأة.

الدوال الإنشائية العامة

RewardedInterstitialAd

public RewardedInterstitialAd()

الطُرق العامة

getAdMetadata

public abstract @NonNull Bundle getAdMetadata()

تعرض هذه السمة جميع البيانات الوصفية المتاحة للإعلان الخاص بـ RewardedInterstitialAd. تكون البيانات الوصفية للإعلان فارغة إذا لم يكن للإعلان بيانات وصفية. قد يتم تعديل البيانات الوصفية للإعلان. استخدِم onAdMetadataChanged للاستماع إلى التغييرات.

getAdUnitId

public abstract @NonNull String getAdUnitId()

تعرِض هذه السمة رقم تعريف الوحدة الإعلانية.

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

تعرض هذه السمة FullScreenContentCallback الخاص بـ RewardedInterstitialAd.

getOnAdMetadataChangedListener

public abstract @Nullable OnAdMetadataChangedListener getOnAdMetadataChangedListener()

تعرض هذه السمة OnAdMetadataChangedListener الخاص بـ RewardedInterstitialAd.

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

تعرض هذه السمة OnPaidEventListener الخاص بـ RewardedInterstitialAd.

getPlacementId

public abstract long getPlacementId()

تعرض هذه السمة معرّف موضع الإعلان الخاص بـ RewardedInterstitialAd.

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

تعرِض هذه السمة معلومات عن الإعلان الذي تم تحميله.

getRewardItem

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" يتضمّن معلومات الاستهداف
@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	دالّة ردّ اتصال سيتم استدعاؤها عند انتهاء تحميل "إعلان بيني مقابل مكافأة".

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

تسجّل هذه السمة دالة ردّ نداء سيتم استدعاؤها عندما تعرض الإعلانات محتوى بملء الشاشة ويتم إغلاقه.

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

تضبط هذه الطريقة علامة تحكّم في ما إذا كان سيتم عرض عنصر "الإعلان البيني الذي يقدّم مكافأة" في وضع ملء الشاشة. يجب استدعاء هذه الطريقة قبل show. أثناء show، إذا تم تفعيل هذا الخيار وكان الوضع الغامر متاحًا، سيتم تفعيل SYSTEM_UI_FLAG_IMMERSIVE_STICKY وSYSTEM_UI_FLAG_HIDE_NAVIGATION للإعلان مقابل مكافأة.

setOnAdMetadataChangedListener

public abstract void setOnAdMetadataChangedListener(
    @Nullable OnAdMetadataChangedListener listener
)

تسجِّل هذه الطريقة دالّة ردّ اتصال سيتم استدعاؤها عند تغيُّر البيانات الوصفية للإعلان البيني مقابل مكافأة.

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

تسجِّل هذه الطريقة دالّة ردّ اتصال سيتم استدعاؤها عندما يُقدّر أنّ هذا الإعلان قد حقّق أرباحًا.

setPlacementId

public abstract void setPlacementId(long placementId)

تضبط هذه السمة معرّف موضع الإعلان للإعلان البيني مقابل مكافأة.

لضمان تضمين رقم تعريف موضع الإعلان هذا في التقارير، استدعِ هذه الطريقة قبل عرض الإعلان.

المعلمات
long placementId	عدد صحيح طويل توفّره واجهة مستخدم AdMob للموضع الإعلاني الذي تم ضبطه.

setServerSideVerificationOptions

public abstract void setServerSideVerificationOptions(
    ServerSideVerificationOptions options
)

تضبط هذه السمة قيمة ServerSideVerificationOptions لهذا الإعلان البيني مقابل مكافأة.

إظهار

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

تعرِض هذه السمة الإعلان البيني الذي يضمّ مكافأة.

المعلمات
@NonNull Activity activity	النشاط الذي يجب عرض "الإعلان مقابل مكافأة" منه
@NonNull OnUserEarnedRewardListener onUserEarnedRewardListener	يجب إعلام المستمع عندما يحصل المستخدم على مكافأة.