AppOpenAd

Kotlin |Java

abstract class AppOpenAd

---

تُستخدَم "الإعلانات على شاشة فتح التطبيق" لعرض الإعلانات عندما يدخل المستخدمون إلى تطبيقك. يحتوي العنصر AppOpenAd على جميع البيانات اللازمة لعرض الإعلان. على عكس الإعلانات البينية، تسهّل "الإعلانات على شاشة فتح التطبيق" توفير مساحة خاصة بالعناصر البصرية للعلامة التجارية للتطبيق كي يفهم المستخدمون السياق الذي يظهر فيه الإعلان. استخدِم إحدى طرق load الثابتة لتحميل AppOpenAd. ثم استدعِ الدالة show لعرضها.

ملخّص

الأنواع المتداخلة
abstract class AppOpenAd.AppOpenAdLoadCallback : AdLoadCallback عنصر لتلقّي إشعارات الأحداث عند تحميل إعلان عن فتح التطبيق.

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

الوظائف العامة
abstract String	getAdUnitId() تعرِض هذه السمة رقم تعريف الوحدة الإعلانية.
abstract FullScreenContentCallback?	getFullScreenContentCallback() تعرض هذه السمة FullScreenContentCallback الخاص بـ AppOpenAd.
abstract OnPaidEventListener?	getOnPaidEventListener() تعرض هذه السمة OnPaidEventListener الخاص بـ AppOpenAd.
abstract Long	getPlacementId() تعرض هذه السمة معرّف موضع الإعلان الخاص بـ AppOpenAd.
abstract ResponseInfo	getResponseInfo() تعرِض هذه السمة ResponseInfo للإعلان الذي تم تحميله.
java-static Boolean	isAdAvailable(context: Context, adUnitId: String) تم إيقاف هذه الدالة نهائيًا. يمكنك استخدام isAdAvailable كبديل.
java-static Unit	load(     context: Context!,     adUnitId: String!,     adRequest: AdRequest!,     loadCallback: AppOpenAd.AppOpenAdLoadCallback! ) تحميل AppOpenAd
java-static AppOpenAd?	pollAd(context: Context, adUnitId: String) تم إيقاف هذه الدالة نهائيًا. يمكنك استخدام pollAd كبديل.
abstract Unit	setFullScreenContentCallback(     fullScreenContentCallback: FullScreenContentCallback? ) تسجّل هذه السمة دالة ردّ نداء سيتم استدعاؤها عندما تعرض الإعلانات محتوى بملء الشاشة ويتم إغلاقه.
abstract Unit	setImmersiveMode(immersiveModeEnabled: Boolean) تضبط هذه السمة علامة تحكّم في ما إذا كان سيتم عرض عنصر الإعلان على شاشة فتح التطبيق هذا في الوضع الغامر.
abstract Unit	setOnPaidEventListener(listener: OnPaidEventListener?) تسجِّل هذه الطريقة دالّة ردّ اتصال سيتم استدعاؤها عندما يُقدّر أنّ هذا الإعلان قد حقّق أرباحًا.
abstract Unit	setPlacementId(placementId: Long) تضبط هذه السمة معرّف موضع الإعلان الخاص بـ "الإعلان على شاشة فتح التطبيق".
abstract Unit	show(activity: Activity) تعرض هذه الطريقة الإعلان عن طريق فتح التطبيق.

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

AppOpenAd

AppOpenAd()

الوظائف العامة

getAdUnitId

abstract fun getAdUnitId(): String

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

getFullScreenContentCallback

abstract fun getFullScreenContentCallback(): FullScreenContentCallback?

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

getOnPaidEventListener

abstract fun getOnPaidEventListener(): OnPaidEventListener?

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

getPlacementId

abstract fun getPlacementId(): Long

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

getResponseInfo

abstract fun getResponseInfo(): ResponseInfo

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

isAdAvailable

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

تم إيقاف هذه الوظيفة نهائيًا.

يمكنك استخدام isAdAvailable كبديل.

تعرِض هذه الطريقة القيمة true إذا كان هناك إعلان أثناء فتح التطبيق متوفّر تم تحميله من startPreload.

حمولة

java-static fun load(
    context: Context!,
    adUnitId: String!,
    adRequest: AdRequest!,
    loadCallback: AppOpenAd.AppOpenAdLoadCallback!
): Unit

تحميل AppOpenAd

المعلمات
context: Context!	السياق
adUnitId: String!	معرّف الوحدة الإعلانية
adRequest: AdRequest!	طلب إعلان يتضمّن معلومات الاستهداف
loadCallback: AppOpenAd.AppOpenAdLoadCallback!	عنصر يعالج أحداث تحميل "إعلان على شاشة فتح التطبيق".

pollAd

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

تم إيقاف هذه الوظيفة نهائيًا.

يمكنك استخدام pollAd كبديل.

يستردّ هذا الإجراء الإعلان التالي عن فتح التطبيق الذي تم تحميله من startPreload، أو null إذا لم يتوفّر أي إعلان.

setFullScreenContentCallback

abstract fun setFullScreenContentCallback(
    fullScreenContentCallback: FullScreenContentCallback?
): Unit

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

setImmersiveMode

abstract fun setImmersiveMode(immersiveModeEnabled: Boolean): Unit

تضبط هذه السمة علامة تحكّم في ما إذا كان سيتم عرض عنصر الإعلان على شاشة فتح التطبيق هذا في الوضع الغامر. يجب استدعاء هذه الطريقة قبل 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

تضبط هذه السمة معرّف موضع الإعلان الخاص بـ "الإعلان على شاشة فتح التطبيق".

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

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

إظهار

abstract fun show(activity: Activity): Unit

تعرض هذه الطريقة الإعلان عن طريق فتح التطبيق.

المعلمات
activity: Activity	النشاط الذي يتم عرض إعلان AppOpenAd منه