درخواست تبلیغات
class AdRequest
AdManagerAdRequest | یک |
یک AdRequest حاوی اطلاعات هدفگیری است که برای دریافت یک تبلیغ استفاده میشود. درخواستهای تبلیغ با استفاده از AdRequest.Builder ایجاد میشوند.
ناشرانی که از Ad Manager استفاده میکنند باید از com.google.android.gms.ads.admanager.AdManagerAdRequest استفاده کنند.
خلاصه
انواع تو در تو |
|---|
یک |
ثابتها | |
|---|---|
const String ! | DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB" |
const Int | درخواست تبلیغ به دلیل فقدان شناسه برنامه انجام نشد. |
const Int | اتفاقی در داخل رخ داده است؛ برای مثال، یک پاسخ نامعتبر از سرور تبلیغات دریافت شده است. |
const Int | رشته آگهی نامعتبر است. |
const Int | درخواست تبلیغ نامعتبر بود؛ برای مثال، شناسه واحد تبلیغ نادرست بود. |
const Int | آداپتور میانجیگری درخواست تبلیغ را برآورده نکرد. |
const Int | درخواست تبلیغ به دلیل اتصال به شبکه ناموفق بود. |
const Int | درخواست آگهی موفقیتآمیز بود، اما به دلیل کمبود موجودی آگهی، هیچ آگهیای بازگردانده نشد. |
const Int | شناسه درخواست در رشته آگهی یافت نشد. |
const Int | MAX_CONTENT_URL_LENGTH = 512حداکثر طول URL محتوا. |
کارکردهای عمومی | |
|---|---|
String ? | getAdString ()رشته تبلیغ را دریافت میکند. |
String ! | اطلاعات هدفگیری URL محتوا را برمیگرداند. |
Bundle ? | <T : CustomEvent ?> این تابع منسوخ شده است. به جای آن |
( Mutable ) Set < String !>! | getKeywords ()کلمات کلیدی اطلاعاتی را که هدف قرار میدهند، برمیگرداند. |
( Mutable ) List < String !>! | لیستی از URL های محتوای همسایه یا اگر هیچ URL تنظیم نشده باشد، یک لیست خالی را برمیگرداند. |
Bundle ? | <T : MediationExtrasReceiver ?> getNetworkExtrasBundle (پارامترهای اضافی را برای ارسال به یک آداپتور شبکه تبلیغاتی خاص برمیگرداند. |
Long | شناسهی قرارگیری تنظیمشده در این |
String ! | Returns the request agent string to identify ad request's origin. |
Boolean | isTestDevice (context: Context !) اگر این دستگاه تبلیغات آزمایشی دریافت کند، |
ثابتها
شبیهساز شناسه دستگاه
const val DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB": String!
deviceId برای شبیهسازهایی که قرار است با setTestDeviceIds استفاده شوند.
کد خطا_شناسه_برنامه_ناموجود
const val ERROR_CODE_APP_ID_MISSING = 8: Int
درخواست تبلیغ به دلیل فقدان شناسه برنامه انجام نشد.
خطا_کد_داخلی
const val ERROR_CODE_INTERNAL_ERROR = 0: Int
اتفاقی در داخل رخ داده است؛ برای مثال، یک پاسخ نامعتبر از سرور تبلیغات دریافت شده است.
کد_خطا_INVALID_AD_STRING
const val ERROR_CODE_INVALID_AD_STRING = 11: Int
رشته تبلیغ نامعتبر است. برای مثال، هیچ شناسه درخواستی در رشته تبلیغ وجود ندارد.
کد_خطا_درخواست_نامعتبر
const val ERROR_CODE_INVALID_REQUEST = 1: Int
درخواست تبلیغ نامعتبر بود؛ برای مثال، شناسه واحد تبلیغ نادرست بود.
کد_خطا_درمان_بدون_تکمیل
const val ERROR_CODE_MEDIATION_NO_FILL = 9: Int
The mediation adapter did not fill the ad request. If this error is returned from getCode , check getCause for the underlying cause.
خطا_کد_شبکه
const val ERROR_CODE_NETWORK_ERROR = 2: Int
درخواست تبلیغ به دلیل اتصال به شبکه ناموفق بود.
کد خطا: شماره پر کردن: ندارد
const val ERROR_CODE_NO_FILL = 3: Int
درخواست آگهی موفقیتآمیز بود، اما به دلیل کمبود موجودی آگهی، هیچ آگهیای بازگردانده نشد.
کد_خطا_درخواست_شناسه_عدم_تطابق
const val ERROR_CODE_REQUEST_ID_MISMATCH = 10: Int
شناسه درخواست در رشته آگهی یافت نشد.
حداکثر طول آدرس اینترنتی (MAX_CONTENT_URL)
const val MAX_CONTENT_URL_LENGTH = 512: Int
حداکثر طول URL محتوا.
کارکردهای عمومی
دریافت آدرس محتوا
fun getContentUrl(): String!
اطلاعات هدفگیری URL محتوا را برمیگرداند. اگر contentUrl تنظیم نشده باشد، null را برمیگرداند.
بسته الحاقی getCustomEventExtras
fun <T : CustomEvent?>getCustomEventExtrasBundle(adapterClass: Class<T!>!): Bundle?
Returns extra parameters to pass to a specific custom event adapter. Returns null if no custom event extras of the provided type were set.
دریافت کلمات کلیدی
fun getKeywords(): (Mutable)Set<String!>!
Returns targeting information keywords. Returns an empty Set if no keywords were added.
آدرسهای محتوای همسایه را دریافت کنید
fun getNeighboringContentUrls(): (Mutable)List<String!>!
Returns the list of neighboring content URLs or an empty list if no URLs were set.
بستهی الحاقی getNetworkExtras
fun <T : MediationExtrasReceiver?> getNetworkExtrasBundle(
adapterClass: Class<T!>!
): Bundle?
Returns extra parameters to pass to a specific ad network adapter. Returns null if no network extras of the provided type were set.
دریافت شناسهی مکان
fun getPlacementId(): Long
شناسهی قرارگیری تنظیمشده در این AdRequest را دریافت میکند.
getRequestAgent
fun getRequestAgent(): String!
Returns the request agent string to identify ad request's origin.
isTestDevice
fun isTestDevice(context: Context!): Boolean
Returns true if this device will receive test ads.