AdRequest

Kotlin |Java

class AdRequest

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

AdManagerAdRequest

AdManagerAdRequest

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

---

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

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

ملخّص

الأنواع المتداخلة
class AdRequest.Builder : AbstractAdRequestBuilder إنشاء AdRequest

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

الوظائف العامة
String?	getAdString() تحصل على سلسلة الإعلان.
String!	getContentUrl() تعرِض هذه السمة معلومات استهداف عنوان URL للمحتوى.
Bundle?	<T : CustomEvent?> getCustomEventExtrasBundle(adapterClass: Class<T!>!) تم إيقاف هذه الوظيفة نهائيًا. استخدِم getNetworkExtrasBundle بدلاً من ذلك.
(Mutable)Set<String!>!	getKeywords() تعرِض هذه السمة الكلمات الرئيسية لمعلومات الاستهداف.
(Mutable)List<String!>!	getNeighboringContentUrls() تعرِض هذه السمة قائمة عناوين URL للمحتوى المجاور أو قائمة فارغة إذا لم يتم ضبط أي عناوين URL.
Bundle?	<T : MediationExtrasReceiver?> getNetworkExtrasBundle(     adapterClass: Class<T!>! ) تعرِض هذه السمة مَعلمات إضافية لنقلها إلى محوِّل شبكة إعلانات معيّن.
String!	getRequestAgent() تعرِض سلسلة وكيل الطلب لتحديد مصدر طلب الإعلان.
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?

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

استخدِم getNetworkExtrasBundle بدلاً من ذلك.

تعرِض هذه السمة مَعلمات إضافية لنقلها إلى محوِّل حدث مخصّص محدّد. تعرِض القيمة 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 إذا لم يتم ضبط أيّ إضافات شبكة من النوع المقدَّم.

getRequestAgent

fun getRequestAgent(): String!

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

isTestDevice

fun isTestDevice(context: Context!): Boolean

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