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	يجب إعلام أداة معالجة الأحداث هذه عندما يحصل المستخدم على مكافأة.