AdRequest

Kotlin |Java

class AdRequest

מחלקות משנה ישירות מוכרות

AdManagerAdRequest

AdManagerAdRequest

תג AdManagerAdRequest מכיל מידע על טירגוט שמשמש לאחזור מודעה מ-Google Ad Manager.

---

תג AdRequest מכיל מידע על טירגוט שמשמש לאחזור מודעה. בקשות להצגת מודעות נוצרות באמצעות AdRequest.Builder.

בעלי תוכן דיגיטלי שמשתמשים ב-Ad Manager צריכים להשתמש בכתובת 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!>! ) מחזירה פרמטרים נוספים להעברה למתאם של רשת מודעות ספציפית.
Long	getPlacementId() מקבלת את מזהה מיקום המודעה שהוגדר ב-AdRequest הזה
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 אם לא הוגדרו תוספים לערוץ מהסוג שצוין.

getPlacementId

fun getPlacementId(): Long

מקבלת את מזהה מיקום המודעה שהוגדר ב-AdRequest הזה

getRequestAgent

fun getRequestAgent(): String!

הפונקציה מחזירה את מחרוזת סוכן הבקשה כדי לזהות את המקור של הבקשה להצגת מודעה.

isTestDevice

fun isTestDevice(context: Context!): Boolean

הפונקציה מחזירה true אם המכשיר הזה יקבל מודעות לבדיקה.