歡迎加入 Google 廣告與評估社群站的官方 AdMob Discord 頻道，一起討論產品並交流心得。

AdManagerAdRequest

Kotlin |Java

class AdManagerAdRequest : AdRequest

kotlin.Any
↳	com.google.android.gms.ads.AdRequest
	↳	com.google.android.gms.ads.admanager.AdManagerAdRequest

AdManagerAdRequest 內含用於從 Google Ad Manager 擷取廣告的指定目標資訊。廣告請求是使用 AdManagerAdRequest.Builder 建立。

摘要

巢狀型別
`class AdManagerAdRequest.Builder : AbstractAdRequestBuilder` 建構 `AdManagerAdRequest`。

公開函式
`Bundle!`	`getCustomTargeting()` 傳回自訂指定目標參數。
`String!`	`getPublisherProvidedId()` 傳回用於展示頻率上限、目標對象區隔和指定目標、廣告依序輪播，以及其他以目標對象為基礎的跨裝置廣告放送控制項的 ID。

`const String!`	`DEVICE_ID_EMULATOR = "B3EEABB8EE11C2BE770B684D95219ECB"` `deviceId` 適用於搭配 `setTestDeviceIds` 使用的模擬器。
`const Int`	`ERROR_CODE_APP_ID_MISSING = 8` 由於缺少應用程式 ID，因此未提出廣告請求。
`const Int`	`ERROR_CODE_INTERNAL_ERROR = 0` 發生內部錯誤，例如從廣告伺服器收到無效回應。
`const Int`	`ERROR_CODE_INVALID_AD_STRING = 11` 廣告字串無效。
`const Int`	`ERROR_CODE_INVALID_REQUEST = 1` 廣告請求無效，例如廣告單元 ID 不正確。
`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` 找不到廣告字串中的要求 ID。
`const Int`	`MAX_CONTENT_URL_LENGTH = 512` 內容網址長度上限。

`String?`	`getAdString()` 取得廣告字串。
`String!`	`getContentUrl()` 傳回內容網址指定目標資訊。
`Bundle?`	`<T : CustomEvent?> getCustomEventExtrasBundle(adapterClass: Class<T!>!)` 此函式已淘汰。請改用 `getNetworkExtrasBundle`。
`(Mutable)Set<String!>!`	`getKeywords()` 傳回指定目標資訊關鍵字。
`(Mutable)List<String!>!`	`getNeighboringContentUrls()` 傳回鄰近內容網址清單，如果未設定任何網址，則傳回空白清單。
`Bundle?`	`<T : MediationExtrasReceiver?> getNetworkExtrasBundle( adapterClass: Class<T!>! )` 傳回要傳遞至特定廣告聯播網介面的額外參數。
`Long`	`getPlacementId()` 取得此 `AdRequest` 中設定的刊登位置 ID
`String!`	`getRequestAgent()` 傳回要求代理程式字串，以識別廣告要求的來源。
`Boolean`	`isTestDevice(context: Context!)` 如果這個裝置會收到測試廣告，則傳回 `true`。

fun getCustomTargeting(): Bundle!

傳回自訂指定目標參數。

fun getPublisherProvidedId(): String!

傳回用於展示頻率上限、目標對象區隔和指定目標、廣告依序輪播，以及其他以目標對象為基礎的跨裝置廣告放送控制項的 ID。