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()

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