AdRequest

class AdRequest

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

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

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

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

ملخّص

الأنواع المتداخلة

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

الثوابت
const String!
DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB"

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

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

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

سلسلة الإعلان غير صالحة.
const Int

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

لم يملأ وسيط التوسّط طلب الإعلان.
const Int

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

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

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

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

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

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

تعرِض هذه السمة معلومات استهداف عنوان URL الخاص بالمحتوى.
Bundle?
<T : CustomEvent?> getCustomEventExtrasBundle(adapterClass: Class<T!>!)

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

يمكنك استخدام getNetworkExtrasBundle كبديل.
(Mutable)Set<String!>!

تعرض هذه السمة الكلمات الرئيسية لمعلومات الاستهداف.
(Mutable)List<String!>!

تعرِض هذه السمة قائمة بعناوين URL للمحتوى المجاور أو قائمة فارغة إذا لم يتم ضبط أي عناوين URL.
Bundle?
<T : MediationExtrasReceiver?> getNetworkExtrasBundle(
    adapterClass: Class<T!>!
)

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

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

تعرِض هذه السمة سلسلة وكيل الطلب لتحديد مصدر طلب الإعلان.
Boolean
isTestDevice(context: Context!)

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

الثوابت

DEVICE_ID_EMULATOR

const val DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB": String!

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

ERROR_CODE_APP_ID_MISSING

const val ERROR_CODE_APP_ID_MISSING = 8: Int

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

ERROR_CODE_INTERNAL_ERROR

const val ERROR_CODE_INTERNAL_ERROR = 0: Int

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

ERROR_CODE_INVALID_AD_STRING

const val ERROR_CODE_INVALID_AD_STRING = 11: Int

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

ERROR_CODE_INVALID_REQUEST

const val ERROR_CODE_INVALID_REQUEST = 1: Int

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

ERROR_CODE_MEDIATION_NO_FILL

const val ERROR_CODE_MEDIATION_NO_FILL = 9: Int

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

ERROR_CODE_NETWORK_ERROR

const val ERROR_CODE_NETWORK_ERROR = 2: Int

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

ERROR_CODE_NO_FILL

const val ERROR_CODE_NO_FILL = 3: Int

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

ERROR_CODE_REQUEST_ID_MISMATCH

const val ERROR_CODE_REQUEST_ID_MISMATCH = 10: Int

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

MAX_CONTENT_URL_LENGTH

const val MAX_CONTENT_URL_LENGTH = 512: Int

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

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

getAdString

fun getAdString(): String?

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

getContentUrl

fun getContentUrl(): String!

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

getCustomEventExtrasBundle

fun <T : CustomEvent?> getCustomEventExtrasBundle(adapterClass: Class<T!>!): Bundle?

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

getKeywords

fun getKeywords(): (Mutable)Set<String!>!

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

getNeighboringContentUrls

fun getNeighboringContentUrls(): (Mutable)List<String!>!

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

getNetworkExtrasBundle

fun <T : MediationExtrasReceiver?> getNetworkExtrasBundle(
    adapterClass: Class<T!>!
): Bundle?

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

getPlacementId

fun getPlacementId(): Long

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

getRequestAgent

fun getRequestAgent(): String!

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

isTestDevice

fun isTestDevice(context: Context!): Boolean

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