درخواست تبلیغات 

public class AdRequest

زیرکلاس‌های مستقیم شناخته‌شده‌ی AdManagerAdRequest
AdManagerAdRequest

یک AdManagerAdRequest حاوی اطلاعات هدف‌گیری است که برای دریافت یک تبلیغ از Google Ad Manager استفاده می‌شود.

یک AdRequest حاوی اطلاعات هدف‌گیری است که برای دریافت یک تبلیغ استفاده می‌شود. درخواست‌های تبلیغ با استفاده از AdRequest.Builder ایجاد می‌شوند.

ناشرانی که از Ad Manager استفاده می‌کنند باید از com.google.android.gms.ads.admanager.AdManagerAdRequest استفاده کنند.

خلاصه

انواع تو در تو

یک AdRequest می‌سازد.

ثابت‌ها

static final String
DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB"

deviceId برای شبیه‌سازهایی که قرار است با setTestDeviceIds استفاده شوند.

static final int

درخواست تبلیغ به دلیل فقدان شناسه برنامه انجام نشد.

static final int

اتفاقی در داخل رخ داده است؛ برای مثال، یک پاسخ نامعتبر از سرور تبلیغات دریافت شده است.

static final int

رشته آگهی نامعتبر است.

static final int

درخواست تبلیغ نامعتبر بود؛ برای مثال، شناسه واحد تبلیغ نادرست بود.

static final int

آداپتور میانجیگری درخواست تبلیغ را برآورده نکرد.

static final int

درخواست تبلیغ به دلیل اتصال به شبکه ناموفق بود.

static final int

درخواست آگهی موفقیت‌آمیز بود، اما به دلیل کمبود موجودی آگهی، هیچ آگهی‌ای بازگردانده نشد.

static final int

شناسه درخواست در رشته آگهی یافت نشد.

static final int

حداکثر طول URL محتوا.

روش‌های عمومی

@ Nullable String

رشته تبلیغ را دریافت می‌کند.

String

اطلاعات هدف‌گیری URL محتوا را برمی‌گرداند.

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

این روش منسوخ شده است.

به جای آن getNetworkExtrasBundle استفاده کنید.

Set < String >

کلمات کلیدی اطلاعاتی را که هدف قرار می‌دهند، برمی‌گرداند.

List < String >

لیستی از URL های محتوای همسایه یا اگر هیچ URL تنظیم نشده باشد، یک لیست خالی را برمی‌گرداند.

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

پارامترهای اضافی را برای ارسال به یک آداپتور شبکه تبلیغاتی خاص برمی‌گرداند.

long

شناسه‌ی قرارگیری تنظیم‌شده در این AdRequest را دریافت می‌کند.

String

رشته‌ی عامل درخواست را برمی‌گرداند تا مبدا درخواست تبلیغ را شناسایی کند.

boolean
isTestDevice ( Context context)

اگر این دستگاه تبلیغات آزمایشی دریافت کند، true را برمی‌گرداند.

ثابت‌ها

شبیه‌ساز شناسه دستگاه 

public static final String DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB"

deviceId برای شبیه‌سازهایی که قرار است با setTestDeviceIds استفاده شوند.

کد خطا_شناسه_برنامه_ناموجود 

public static final int ERROR_CODE_APP_ID_MISSING = 8

درخواست تبلیغ به دلیل فقدان شناسه برنامه انجام نشد.

خطا_کد_داخلی 

public static final int ERROR_CODE_INTERNAL_ERROR = 0

اتفاقی در داخل رخ داده است؛ برای مثال، یک پاسخ نامعتبر از سرور تبلیغات دریافت شده است.

کد_خطا_INVALID_AD_STRING 

public static final int ERROR_CODE_INVALID_AD_STRING = 11

رشته تبلیغ نامعتبر است. برای مثال، هیچ شناسه درخواستی در رشته تبلیغ وجود ندارد.

کد_خطا_درخواست_نامعتبر 

public static final int ERROR_CODE_INVALID_REQUEST = 1

درخواست تبلیغ نامعتبر بود؛ برای مثال، شناسه واحد تبلیغ نادرست بود.

کد_خطا_درمان_بدون_تکمیل 

public static final int ERROR_CODE_MEDIATION_NO_FILL = 9

آداپتور میانجیگری درخواست تبلیغ را برآورده نکرد. اگر این خطا از getCode برگردانده شد، getCause برای علت اصلی بررسی کنید.

خطا_کد_شبکه 

public static final int ERROR_CODE_NETWORK_ERROR = 2

درخواست تبلیغ به دلیل اتصال به شبکه ناموفق بود.

کد خطا: شماره پر کردن: ندارد 

public static final int ERROR_CODE_NO_FILL = 3

درخواست آگهی موفقیت‌آمیز بود، اما به دلیل کمبود موجودی آگهی، هیچ آگهی‌ای بازگردانده نشد.

کد_خطا_درخواست_شناسه_عدم_تطابق 

public static final int ERROR_CODE_REQUEST_ID_MISMATCH = 10

شناسه درخواست در رشته آگهی یافت نشد.

حداکثر طول آدرس اینترنتی (MAX_CONTENT_URL) 

public static final int MAX_CONTENT_URL_LENGTH = 512

حداکثر طول URL محتوا.

روش‌های عمومی

دریافت رشته تبلیغاتی 

public @Nullable String getAdString()

رشته تبلیغ را دریافت می‌کند.

دریافت آدرس محتوا 

public String getContentUrl()

اطلاعات هدف‌گیری URL محتوا را برمی‌گرداند. اگر contentUrl تنظیم نشده باشد، null را برمی‌گرداند.

بسته الحاقی getCustomEventExtras 

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

پارامترهای اضافی را برای ارسال به یک آداپتور رویداد سفارشی خاص برمی‌گرداند. در صورتی که هیچ رویداد سفارشی اضافی از نوع ارائه شده تنظیم نشده باشد، null را برمی‌گرداند.

دریافت کلمات کلیدی 

public Set<String> getKeywords()

کلمات کلیدی اطلاعات هدف را برمی‌گرداند. اگر هیچ کلمه کلیدی اضافه نشده باشد، یک Set خالی برمی‌گرداند.

آدرس‌های محتوای همسایه را دریافت کنید 

public List<String> getNeighboringContentUrls()

لیستی از URL های محتوای همسایه یا اگر هیچ URL تنظیم نشده باشد، یک لیست خالی را برمی‌گرداند.

بسته‌ی الحاقی getNetworkExtras 

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

پارامترهای اضافی را برای ارسال به یک آداپتور شبکه تبلیغاتی خاص برمی‌گرداند. اگر هیچ پارامتر اضافی شبکه‌ای از نوع ارائه شده تنظیم نشده باشد، null را برمی‌گرداند.

دریافت شناسه‌ی مکان 

public long getPlacementId()

شناسه‌ی قرارگیری تنظیم‌شده در این AdRequest را دریافت می‌کند.

getRequestAgent 

public String getRequestAgent()

رشته‌ی عامل درخواست را برمی‌گرداند تا مبدا درخواست تبلیغ را شناسایی کند.

isTestDevice 

public boolean isTestDevice(Context context)

اگر این دستگاه تبلیغات آزمایشی دریافت کند، true را برمی‌گرداند.