Interface NativeAdRequest

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

الخصائص

Optional Readonly adChoicesPlacement

adChoicesPlacement?: AdChoicesPlacement
موضع "خيارات الإعلان"

Optional Readonly adSizes

adSizes?: readonly AdSize[]
قائمة بأحجام الإعلانات الصالحة للطلب.

تتوفّر هذه الميزة لناشري "إدارة إعلانات Google" فقط.

Readonly adUnitId

adUnitId: string
رقم تعريف الوحدة الإعلانية.

Optional Readonly aspectRatio

aspectRatio?: NativeMediaAspectRatio
نسبة العرض إلى الارتفاع للوسائط التي سيتم عرضها

Optional Readonly categoryExclusions

categoryExclusions?: readonly string[]
تصنيفات استبعاد فئات الإعلانات على مستوى موضع الإعلان:

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

Optional Readonly contentUrl

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

Optional Readonly customClickGestureAllowTaps

customClickGestureAllowTaps?: boolean
تحدّد هذه السمة ما إذا كان خيار "النقر للتفعيل" مفعّلاً باستخدام إيماءة النقر المخصّصة.

تتوفّر هذه السمة للناشرين المُدرَجين في القائمة المسموح بها فقط. ويتم تجاهل هذه الإعدادات للناشرين غير المدرَجين في القائمة المسموح بها.

Optional Readonly customFormatIds

customFormatIds?: readonly string[]
قائمة بمعرّفات أشكال الإعلانات المخصّصة المدمجة مع المحتوى المحدّدة في واجهة مستخدم Ad Manager.

تُستخدَم لتحميل الإعلانات المدمجة مع المحتوى من النوع NativeAdType.CUSTOM_NATIVE.
انظر أيضًا

Optional Readonly customTargeting

customTargeting?: Readonly<Record<string, string | readonly string[]>>
مَعلمات الاستهداف المخصّص:

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

‫Optional Readonly إضافات

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 nativeAdTypes

nativeAdTypes?: readonly NativeAdType[]
قائمة بأنواع الإعلانات المدمجة مع المحتوى للطلب.

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 الخاصة بالطلب.