AdRequest

Kotlin |Java

public class AdRequest

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

AdManagerAdRequest

AdManagerAdRequest

تحتوي AdManagerAdRequest على معلومات الاستهداف المستخدَمة لجلب إعلان من "مدير إعلانات Google".

---

يحتوي AdRequest على معلومات الاستهداف المستخدَمة لجلب إعلان. يتم إنشاء طلبات الإعلانات باستخدام AdRequest.Builder.

على الناشرين الذين يستخدمون "مدير إعلانات Google" استخدام com.google.android.gms.ads.admanager.AdManagerAdRequest.

ملخّص

الأنواع المتداخلة
public class AdRequest.Builder extends AbstractAdRequestBuilder تنشئ هذه الدالة AdRequest.

الثوابت
static final String	DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB" deviceId للمحاكيات التي سيتم استخدامها مع setTestDeviceIds
static final int	ERROR_CODE_APP_ID_MISSING = 8 لم يتم إرسال طلب الإعلان بسبب عدم توفّر معرّف التطبيق.
static final int	ERROR_CODE_INTERNAL_ERROR = 0 حدثت مشكلة ما داخليًا، على سبيل المثال، تم تلقي استجابة غير صالحة من خادم الإعلانات.
static final int	ERROR_CODE_INVALID_AD_STRING = 11 سلسلة الإعلان غير صالحة.
static final int	ERROR_CODE_INVALID_REQUEST = 1 كان طلب الإعلان غير صالح، مثلاً عندما كان رقم تعريف الوحدة الإعلانية غير صحيح.
static final int	ERROR_CODE_MEDIATION_NO_FILL = 9 لم يملأ وسيط التوسّط طلب الإعلان.
static final int	ERROR_CODE_NETWORK_ERROR = 2 لم ينجح طلب الإعلان بسبب مشكلة في الاتصال بالشبكة.
static final int	ERROR_CODE_NO_FILL = 3 تمّ إرسال طلب الإعلان بنجاح، ولكن لم يتم عرض أي إعلان بسبب عدم توفّر مستودع إعلاني.
static final int	ERROR_CODE_REQUEST_ID_MISMATCH = 10 لم يتم العثور على رقم تعريف الطلب في سلسلة الإعلان.
static final int	MAX_CONTENT_URL_LENGTH = 512 الحد الأقصى لطول عنوان URL الخاص بالمحتوى

الطُرق العامة
@Nullable String	getAdString() تعرض هذه السمة سلسلة الإعلانات.
String	getContentUrl() تعرِض هذه السمة معلومات استهداف عنوان URL الخاص بالمحتوى.
@Nullable Bundle	<T extends CustomEvent> getCustomEventExtrasBundle(Class<T> adapterClass) تم إيقاف هذه الطريقة نهائيًا. يمكنك استخدام getNetworkExtrasBundle كبديل.
Set<String>	getKeywords() تعرض هذه السمة الكلمات الرئيسية لمعلومات الاستهداف.
List<String>	getNeighboringContentUrls() تعرِض هذه السمة قائمة بعناوين URL للمحتوى المجاور أو قائمة فارغة إذا لم يتم ضبط أي عناوين URL.
@Nullable Bundle	<T extends MediationExtrasReceiver> getNetworkExtrasBundle(     Class<T> adapterClass ) تعرض هذه السمة مَعلمات إضافية يتم تمريرها إلى أداة ربط شبكة إعلانات معيّنة.
long	getPlacementId() تعرض هذه السمة AdRequest رقم تعريف موضع الإعلان الذي تم ضبطه.
String	getRequestAgent() تعرِض هذه السمة سلسلة وكيل الطلب لتحديد مصدر طلب الإعلان.
boolean	isTestDevice(Context context) تعرِض هذه السمة القيمة true إذا كان هذا الجهاز سيتلقّى إعلانات اختبارية.

الثوابت

DEVICE_ID_EMULATOR

public static final String DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB"

deviceId للمحاكيات التي سيتم استخدامها مع setTestDeviceIds

ERROR_CODE_APP_ID_MISSING

public static final int ERROR_CODE_APP_ID_MISSING = 8

لم يتم إرسال طلب الإعلان بسبب عدم توفّر معرّف التطبيق.

ERROR_CODE_INTERNAL_ERROR

public static final int ERROR_CODE_INTERNAL_ERROR = 0

حدثت مشكلة ما داخليًا، على سبيل المثال، تم تلقي استجابة غير صالحة من خادم الإعلانات.

ERROR_CODE_INVALID_AD_STRING

public static final int ERROR_CODE_INVALID_AD_STRING = 11

سلسلة الإعلان غير صالحة. على سبيل المثال، لا يتضمّن سلسلة الإعلان معرّف طلب.

ERROR_CODE_INVALID_REQUEST

public static final int ERROR_CODE_INVALID_REQUEST = 1

كان طلب الإعلان غير صالح، مثلاً عندما كان رقم تعريف الوحدة الإعلانية غير صحيح.

ERROR_CODE_MEDIATION_NO_FILL

public static final int ERROR_CODE_MEDIATION_NO_FILL = 9

لم يملأ وسيط التوسّط طلب الإعلان. إذا تم عرض هذا الخطأ من getCode، راجِع getCause لمعرفة السبب الأساسي.

ERROR_CODE_NETWORK_ERROR

public static final int ERROR_CODE_NETWORK_ERROR = 2

لم ينجح طلب الإعلان بسبب مشكلة في الاتصال بالشبكة.

ERROR_CODE_NO_FILL

public static final int ERROR_CODE_NO_FILL = 3

تمّ إرسال طلب الإعلان بنجاح، ولكن لم يتم عرض أي إعلان بسبب عدم توفّر مستودع إعلاني.

ERROR_CODE_REQUEST_ID_MISMATCH

public static final int ERROR_CODE_REQUEST_ID_MISMATCH = 10

لم يتم العثور على رقم تعريف الطلب في سلسلة الإعلان.

MAX_CONTENT_URL_LENGTH

public static final int MAX_CONTENT_URL_LENGTH = 512

الحد الأقصى لطول عنوان URL الخاص بالمحتوى

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

getAdString

public @Nullable String getAdString()

تعرض هذه السمة سلسلة الإعلانات.

getContentUrl

public String getContentUrl()

تعرِض هذه السمة معلومات استهداف عنوان URL الخاص بالمحتوى. تعرِض القيمة null إذا لم يتم ضبط contentUrl.

getCustomEventExtrasBundle

public @Nullable Bundle <T extends CustomEvent> getCustomEventExtrasBundle(Class<T> adapterClass)

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

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

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

getKeywords

public Set<String> getKeywords()

تعرض هذه السمة الكلمات الرئيسية لمعلومات الاستهداف. تعرِض قيمة فارغة Set إذا لم تتم إضافة أي كلمات رئيسية.

getNeighboringContentUrls

public List<String> getNeighboringContentUrls()

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

getNetworkExtrasBundle

public @Nullable Bundle <T extends MediationExtrasReceiver> getNetworkExtrasBundle(
    Class<T> adapterClass
)

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

getPlacementId

public long getPlacementId()

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

getRequestAgent

public String getRequestAgent()

تعرِض هذه السمة سلسلة وكيل الطلب لتحديد مصدر طلب الإعلان.

isTestDevice

public boolean isTestDevice(Context context)

تعرِض هذه السمة القيمة true إذا كان هذا الجهاز سيتلقّى إعلانات اختبارية.