AppOpenAd

Kotlin |Java

public abstract class AppOpenAd

---

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

ملخّص

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

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

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

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

AppOpenAd

public AppOpenAd()

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

getAdUnitId

public abstract @NonNull String getAdUnitId()

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

getFullScreenContentCallback

public abstract @Nullable FullScreenContentCallback getFullScreenContentCallback()

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

getOnPaidEventListener

public abstract @Nullable OnPaidEventListener getOnPaidEventListener()

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

getPlacementId

public abstract long getPlacementId()

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

getResponseInfo

public abstract @NonNull ResponseInfo getResponseInfo()

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

isAdAvailable

public static boolean isAdAvailable(@NonNull Context context, @NonNull String adUnitId)

تم إيقاف استخدام هذه الطريقة.

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

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

حمولة

public static void load(
    Context context,
    String adUnitId,
    AdRequest adRequest,
    AppOpenAd.AppOpenAdLoadCallback loadCallback
)

تحميل AppOpenAd

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

pollAd

public static @Nullable AppOpenAd pollAd(@NonNull Context context, @NonNull String adUnitId)

تم إيقاف استخدام هذه الطريقة.

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

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

setFullScreenContentCallback

public abstract void setFullScreenContentCallback(
    @Nullable FullScreenContentCallback fullScreenContentCallback
)

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

setImmersiveMode

public abstract void setImmersiveMode(boolean immersiveModeEnabled)

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

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

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

setPlacementId

public abstract void setPlacementId(long placementId)

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

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

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

إظهار

public abstract void show(@NonNull Activity activity)

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

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