AbstractAdRequestBuilder

Kotlin |Java

abstract class AbstractAdRequestBuilder<T : AbstractAdRequestBuilder<T!>?>

الفئات الفرعية المباشرة المعروفة

‫AdManagerAdRequest.Builder وAdRequest.Builder

AdManagerAdRequest.Builder	تنشئ هذه الدالة AdManagerAdRequest.
AdRequest.Builder	تنشئ هذه الدالة AdRequest.

---

فئة أداة إنشاء أساسية للمساعدة في إنشاء طلبات الإعلانات.

ملخّص

الوظائف العامة
T!	@CanIgnoreReturnValue addCustomEventExtrasBundle(     adapterClass: Class<CustomEvent!>!,     customEventExtras: Bundle! ) تم إيقاف هذه الدالة نهائيًا. يمكنك استخدام addNetworkExtrasBundle كبديل.
T!	@CanIgnoreReturnValue addCustomTargeting(key: String!, value: String!) تضيف هذه السمة مَعلمة استهداف مخصّصة.
T!	@CanIgnoreReturnValue addCustomTargeting(key: String!, values: (Mutable)List<String!>!) تضيف هذه السمة مَعلمة استهداف مخصّصة تتضمّن قيمًا متعدّدة.
T!	@CanIgnoreReturnValue addKeyword(keyword: String!) تضيف هذه السمة كلمة رئيسية لأغراض الاستهداف.
T!	@CanIgnoreReturnValue addNetworkExtrasBundle(     adapterClass: Class<MediationExtrasReceiver!>!,     networkExtras: Bundle! ) تضيف هذه السمة مَعلمات إضافية لتمريرها إلى أداة ربط شبكة إعلانات معيّنة.
T!	@CanIgnoreReturnValue setAdString(adString: String!) تضبط هذه السمة سلسلة إعلانية تمثّل استجابة إعلان.
T!	@CanIgnoreReturnValue setContentUrl(contentUrl: String!) تضبط هذه السمة عنوان URL الخاص بموقع إلكتروني يتطابق محتواه مع المحتوى الأساسي للتطبيق.
T!	@CanIgnoreReturnValue setHttpTimeoutMillis(httpTimeoutMillis: Int) تضبط هذه السمة مهلة مخصّصة لطلبات HTTPS التي تقدّمها "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" أثناء طلب الإعلان.
T!	@CanIgnoreReturnValue setNeighboringContentUrls(     neighboringContentUrls: (Mutable)List<String!>! ) تضبط هذه السمة عناوين URL التي تمثّل محتوى الويب بالقرب من الإعلان.
T!	@CanIgnoreReturnValue setPlacementId(placementId: Long) تضبط هذه السمة معرّف موضع إعلان تلقائيًا للإعلان الذي تم تحميله.
T!	@CanIgnoreReturnValue setRequestAgent(requestAgent: String!) تضبط هذه السمة سلسلة وكيل الطلب لتحديد مصدر طلب الإعلان.

الدوال المحمية
abstract T!	self() تعرض هذه الدالة مثيل الذات لنوع فرعي محدّد.

الوظائف العامة

addCustomEventExtrasBundle

@CanIgnoreReturnValue
fun addCustomEventExtrasBundle(
    adapterClass: Class<CustomEvent!>!,
    customEventExtras: Bundle!
): T!

تم إيقاف هذه الوظيفة نهائيًا.

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

تضيف هذه السمة مَعلمات إضافية لتمريرها إلى أداة ربط حدث مخصّص معيّن.

المعلمات
adapterClass: Class<CustomEvent!>!	Class لمحوّل الأحداث المخصّص الذي تقدّم له البيانات الإضافية
customEventExtras: Bundle!	Bundle من المعلومات الإضافية التي سيتم تمريرها إلى أداة ربط الأحداث المخصّصة

addCustomTargeting

@CanIgnoreReturnValue
fun addCustomTargeting(key: String!, value: String!): T!

تضيف هذه السمة مَعلمة استهداف مخصّصة. سيؤدي استدعاء هذه الدالة مرة ثانية باستخدام المفتاح نفسه إلى استبدال القيم القديمة.

addCustomTargeting

@CanIgnoreReturnValue
fun addCustomTargeting(key: String!, values: (Mutable)List<String!>!): T!

تضيف هذه السمة مَعلمة استهداف مخصّصة تتضمّن قيمًا متعدّدة. سيؤدي استدعاء هذه الدالة مرة ثانية باستخدام المفتاح نفسه إلى استبدال القيم القديمة.

addKeyword

@CanIgnoreReturnValue
fun addKeyword(keyword: String!): T!

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

addNetworkExtrasBundle

@CanIgnoreReturnValue
fun addNetworkExtrasBundle(
    adapterClass: Class<MediationExtrasReceiver!>!,
    networkExtras: Bundle!
): T!

تضيف هذه السمة مَعلمات إضافية لتمريرها إلى أداة ربط شبكة إعلانات معيّنة.

المعلمات
adapterClass: Class<MediationExtrasReceiver!>!	Class المحوّل الذي يجب أن يتلقّى البيانات الإضافية.
networkExtras: Bundle!	Bundle: معلومات إضافية يتم تمريرها إلى وسيط محوّل الإعلانات.

setAdString

@CanIgnoreReturnValue
fun setAdString(adString: String!): T!

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

setContentUrl

@CanIgnoreReturnValue
fun setContentUrl(contentUrl: String!): T!

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

الرميات
java.lang.NullPointerException	إذا كانت قيمة contentUrl هي {code null}.
java.lang.IllegalArgumentException	إذا كانت contentUrl فارغة أو إذا كان طولها يتجاوز 512 حرفًا

setHttpTimeoutMillis

@CanIgnoreReturnValue
fun setHttpTimeoutMillis(httpTimeoutMillis: Int): T!

تضبط هذه السمة مهلة مخصّصة لطلبات HTTPS التي تقدّمها "حزمة تطوير البرامج (SDK) لإعلانات Google على الأجهزة الجوّالة" أثناء طلب الإعلان.

إذا كان تطبيقك يستخدم التوسّط، لا ينطبق هذا المهلة على طلبات الشبكة التي يتم إجراؤها من خلال حِزم تطوير البرامج (SDK) لشبكات الإعلانات التابعة لجهات خارجية.

المعلمات
httpTimeoutMillis: Int	عدد صحيح يحدّد المهلة الزمنية لبروتوكول HTTPS بالمللي ثانية. سيتم تجاهل أي قيم أقل من 5000 (5 ثوانٍ). القيمة التلقائية هي 60000 (60 ثانية).

setNeighboringContentUrls

@CanIgnoreReturnValue
fun setNeighboringContentUrls(
    neighboringContentUrls: (Mutable)List<String!>!
): T!

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

المعلمات
neighboringContentUrls: (Mutable)List<String!>!	قائمة بعناوين URL للمحتوى المجاور سيتم إرفاقها بعناوين URL الحالية للمحتوى المجاور

setPlacementId

@CanIgnoreReturnValue
fun setPlacementId(placementId: Long): T!

تضبط هذه السمة معرّف موضع إعلان تلقائيًا للإعلان الذي تم تحميله.

بالنسبة إلى إعلانات البانر، ننصحك باستخدام setPlacementId بدلاً من ذلك. يؤدي استدعاء loadAd مع طلب يضبط معرّف موضع الإعلان إلى النتيجة نفسها التي تنتج عن استدعاء setPlacementId.

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

setRequestAgent

@CanIgnoreReturnValue
fun setRequestAgent(requestAgent: String!): T!

تضبط هذه السمة سلسلة وكيل الطلب لتحديد مصدر طلب الإعلان. يجب أن تستدعي مكتبات الجهات الخارجية التي تشير إلى حزمة تطوير البرامج (SDK) لإعلانات الأجهزة الجوّالة هذه الطريقة للإشارة إلى النظام الأساسي الذي نشأ منه طلب الإعلان. على سبيل المثال، إذا كانت شبكة إعلانات تابعة لجهة خارجية تُسمّى "شبكة CoolAds" تتوسّط في الطلبات إلى حزمة تطوير البرامج (SDK) لإعلانات الأجهزة الجوّالة، عليها استدعاء هذه الطريقة باستخدام "CoolAds".

الدوال المحمية

self

protected abstract fun self(): T!

تعرض هذه الدالة مثيل الذات لنوع فرعي محدّد.