واجهة BannerAdRequest

توسيع AdRequest

طلب عرض إعلان بانر.

يجب تقديم قيمة واحدة فقط من adSize أو adSizes.

الخصائص
adSize?	حجم الإعلان المطلوب
adSizes?	قائمة بأحجام الإعلانات الصالحة للطلب
adUnitId	رقم تعريف الوحدة الإعلانية تم الاكتساب من السمة AdRequest.adUnitId
categoryExclusions?	تصنيفات استبعاد فئة الإعلانات على مستوى الموضع الإعلاني تم الاكتساب من السمة AdRequest.categoryExclusions
contentUrl?	عنوان URL للمحتوى الخاص بموقع إلكتروني يتطابق محتواه مع الـ محتوى الأساسي للتطبيق تم الاكتساب من السمة AdRequest.contentUrl
customTargeting?	مَعلمات الاستهداف المخصّص تم الاكتساب من السمة AdRequest.customTargeting
extras?	مَعلمات إضافية يتم تمريرها إلى AdMob أو "إدارة إعلانات Google" تم الاكتساب من السمة AdRequest.extras
keywords?	الكلمات الرئيسية لتنفيذ أغراض الاستهداف تم الاكتساب من السمة AdRequest.keywords
manualImpressionRequested?	ما إذا كان مطلوبًا تفعيل تسجيل مرّات الظهور يدويًا
mediationExtras?	مَعلمات إضافية يتم تمريرها إلى محوّل مصدر إعلان معيّن في إعدادات التوسّط تم الاكتساب من السمة AdRequest.mediationExtras
neighboringContentUrls?	عناوين URL التي تمثّل محتوى الويب بالقرب من إعلان تم الاكتساب من السمة AdRequest.neighboringContentUrls
placementId?	عدد صحيح طويل توفّره واجهة مستخدم AdMob للموضع الإعلاني الذي تم ضبطه تم الاكتساب من السمة AdRequest.placementId
publisherProvidedId?	مُعرّف يُستخدم في تحديد عدد مرّات الظهور وتصنيف الجمهور إلى شرائح واستهدافه وعرض الإعلانات بالتناوب وغيرها من عناصر التحكّم في عرض الإعلانات المستندة إلى الجمهور على جميع الأجهزة تم الاكتساب من السمة AdRequest.publisherProvidedId
skipUninitializedAdapters?	يطلب من حزمة تطوير البرامج (SDK) عدم جمع إشارات عروض الأسعار أو تنفيذ عناصر سلسلة العرض المائي للمحوّلات التي لم يتم إعدادها بنجاح بعد. تم الاكتساب من السمة AdRequest.skipUninitializedAdapters
videoOptions?	السمة VideoOptions للطلب

الخصائص

---

Optional Readonly adSize

adSize?: AdSize | Promise<AdSize>

حجم الإعلان المطلوب

---

Optional Readonly adSizes

adSizes?: readonly (AdSize | Promise<AdSize>)[]

قائمة بأحجام الإعلانات الصالحة للطلب.

تتوفّر هذه الميزة لناشري "إدارة إعلانات Google" فقط. على ناشري AdMob استخدام adSize بدلاً من ذلك.

---

Readonly adUnitId

adUnitId: string

رقم تعريف الوحدة الإعلانية

---

Optional Readonly categoryExclusions

categoryExclusions?: readonly string[]

تصنيفات استبعاد فئة الإعلانات على مستوى الموضع الإعلاني.

لا تنطبق هذه الميزة إلا على طلبات الإعلانات في "إدارة إعلانات Google". يتم تجاهل عمليات استبعاد الفئات في طلبات AdMob.

---

Optional Readonly contentUrl

contentUrl?: string

عنوان URL للمحتوى الخاص بموقع إلكتروني يتطابق محتواه مع المحتوى الأساسي للتطبيق يُستخدم محتوى هذا الموقع الإلكتروني لأغراض الاستهداف و سلامة العلامة التجارية.

---

Optional Readonly customTargeting

customTargeting?: Readonly<Record<string, string | readonly string[]>>

مَعلمات الاستهداف المخصّص.

لا تنطبق هذه الميزة إلا على طلبات الإعلانات في "إدارة إعلانات Google". يتم تجاهل الاستهداف المخصّص في طلبات AdMob

---

Optional Readonly extras

extras?: Readonly<Record<string, unknown>>

مَعلمات إضافية يتم تمريرها إلى AdMob أو "إدارة إعلانات Google".

يجب أن تكون القيم من الأنواع التي يمكن تحويلها إلى JSON (سلاسل أو أرقام أو قيم منطقية أو قيم فارغة، أو صفائف أو كائنات من هذه الأنواع). لا تتوافق هذه الميزة مع الدوال أو مثيلات الفئات أو أنواع JavaScript المعقّدة، مثل Set وMap.

---

Optional Readonly keywords

keywords?: readonly string[]

الكلمات الرئيسية لتنفيذ أغراض الاستهداف

---

Optional Readonly manualImpressionRequested

manualImpressionRequested?: boolean

ما إذا كان مطلوبًا تفعيل تسجيل مرّات الظهور يدويًا

---

Optional Readonly mediationExtras

mediationExtras?: readonly MediationExtras[]

مَعلمات إضافية يتم تمريرها إلى محوّل مصدر إعلان معيّن في إعدادات التوسّط

---

Optional Readonly neighboringContentUrls

neighboringContentUrls?: readonly string[]

عناوين URL التي تمثّل محتوى الويب بالقرب من إعلان تعزّز هذه الميزة سلامة العلامة التجارية و تسمح بعرض إعلانات تحمل تقييمًا على مستوى التطبيق، مثل MA أو T أو PG، يكون أكثر ملاءمة للمحتوى المجاور.

---

Optional Readonly placementId

placementId?: bigint

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

---

Optional Readonly publisherProvidedId

publisherProvidedId?: string

مُعرّف يُستخدم في تحديد عدد مرّات الظهور وتصنيف الجمهور إلى شرائح واستهدافه وعرض الإعلانات بالتناوب وغيرها من عناصر التحكّم في عرض الإعلانات المستندة إلى الجمهور على جميع الأجهزة.

لا تنطبق هذه الميزة إلا على طلبات الإعلانات في "إدارة إعلانات Google". يتم تجاهل أي رقم تعريف في طلبات AdMob.

---

Optional Readonly skipUninitializedAdapters

skipUninitializedAdapters?: boolean

يطلب من حزمة تطوير البرامج (SDK) عدم جمع إشارات عروض الأسعار أو تنفيذ عناصر سلسلة العرض المائي للمحوّلات التي لم يتم إعدادها بنجاح بعد.

---

Optional Readonly videoOptions

videoOptions?: VideoOptions

السمة VideoOptions للطلب