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

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

تعرِض هذه الطريقة إعلان AppOpenAd.

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