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 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 الحالية للمحتوى المجاور

setRequestAgent

@CanIgnoreReturnValue
public T setRequestAgent(String requestAgent)

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

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

self

protected abstract T self()

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