AbstractAdRequestBuilder

Kotlin |Java

public abstract class AbstractAdRequestBuilder<T extends AbstractAdRequestBuilder<T>>

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

‫AdManagerAdRequest.Builder وAdRequest.Builder

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

---

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

ملخّص

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

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

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

addCustomEventExtrasBundle

@CanIgnoreReturnValue
public T addCustomEventExtrasBundle(
    Class<CustomEvent> adapterClass,
    Bundle customEventExtras
)

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

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

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

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

addCustomTargeting

@CanIgnoreReturnValue
public T addCustomTargeting(String key, String value)

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

addCustomTargeting

@CanIgnoreReturnValue
public T addCustomTargeting(String key, List<String> values)

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

addKeyword

@CanIgnoreReturnValue
public T addKeyword(String keyword)

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

addNetworkExtrasBundle

@CanIgnoreReturnValue
public T addNetworkExtrasBundle(
    Class<MediationExtrasReceiver> adapterClass,
    Bundle networkExtras
)

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

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

setAdString

@CanIgnoreReturnValue
public T setAdString(String adString)

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

setContentUrl

@CanIgnoreReturnValue
public T setContentUrl(String contentUrl)

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

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

setHttpTimeoutMillis

@CanIgnoreReturnValue
public T setHttpTimeoutMillis(int httpTimeoutMillis)

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

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

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

setNeighboringContentUrls

@CanIgnoreReturnValue
public T setNeighboringContentUrls(List<String> neighboringContentUrls)

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

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

setPlacementId

@CanIgnoreReturnValue
public T setPlacementId(long placementId)

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

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

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

setRequestAgent

@CanIgnoreReturnValue
public T setRequestAgent(String requestAgent)

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

الطُرق المحمية

self

protected abstract T self()

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