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.

طُرق وضع التصميم العامة

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)

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

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