AbstractAdRequestBuilder

Kotlin |Java

abstract class AbstractAdRequestBuilder<T : AbstractAdRequestBuilder<T!>?>

已知的直接子類別

AdManagerAdRequest.Builder、AdRequest.Builder

AdManagerAdRequest.Builder	建構 AdManagerAdRequest。
AdRequest.Builder	建構 AdRequest。

---

基礎建構工具類別，可協助建構廣告請求。

摘要

公開函式
T!	@CanIgnoreReturnValue addCustomEventExtrasBundle(     adapterClass: Class<CustomEvent!>!,     customEventExtras: Bundle! ) 此函式已淘汰。 請改用 addNetworkExtrasBundle。
T!	@CanIgnoreReturnValue addCustomTargeting(key: String!, value: String!) 新增自訂指定目標參數。
T!	@CanIgnoreReturnValue addCustomTargeting(key: String!, values: (Mutable)List<String!>!) 新增具有多個值的自訂指定目標參數。
T!	@CanIgnoreReturnValue addKeyword(keyword: String!) 新增用於指定目標的關鍵字。
T!	@CanIgnoreReturnValue addNetworkExtrasBundle(     adapterClass: Class<MediationExtrasReceiver!>!,     networkExtras: Bundle! ) 新增額外參數，傳遞至特定廣告聯播網介面卡。
T!	@CanIgnoreReturnValue setAdString(adString: String!) 設定代表廣告回應的廣告字串。
T!	@CanIgnoreReturnValue setContentUrl(contentUrl: String!) 設定網站的內容網址，該網站的內容與應用程式的主要內容相符。
T!	@CanIgnoreReturnValue setHttpTimeoutMillis(httpTimeoutMillis: Int) 為 Google Mobile Ads SDK 在廣告請求期間發出的 HTTPS 呼叫設定自訂逾時。
T!	@CanIgnoreReturnValue setNeighboringContentUrls(     neighboringContentUrls: (Mutable)List<String!>! ) 設定代表廣告附近網頁內容的網址。
T!	@CanIgnoreReturnValue setPlacementId(placementId: Long) 為載入的廣告設定預設刊登位置 ID。
T!	@CanIgnoreReturnValue setRequestAgent(requestAgent: String!) 設定要求代理程式字串，以識別廣告要求的來源。

受保護的函式
abstract T!	self() 傳回指定子類型的自我執行個體。

公開函式

addCustomEventExtrasBundle

@CanIgnoreReturnValue
fun addCustomEventExtrasBundle(
    adapterClass: Class<CustomEvent!>!,
    customEventExtras: Bundle!
): T!

此函式已淘汰。

請改用 addNetworkExtrasBundle。

加入額外參數，傳送至特定自訂事件轉接程式。

參數
adapterClass: Class<CustomEvent!>!	您要提供額外項目的自訂事件轉接程式 Class。
customEventExtras: Bundle!	要傳遞至自訂事件介面的額外資訊 Bundle。

addCustomTargeting

@CanIgnoreReturnValue
fun addCustomTargeting(key: String!, value: String!): T!

新增自訂指定目標參數。如果使用相同鍵再次呼叫這個函式，系統會覆寫舊值。

addCustomTargeting

@CanIgnoreReturnValue
fun addCustomTargeting(key: String!, values: (Mutable)List<String!>!): T!

新增具有多個值的自訂指定目標參數。如果使用相同鍵再次呼叫這個函式，系統會覆寫舊值。

addKeyword

@CanIgnoreReturnValue
fun addKeyword(keyword: String!): T!

新增用於指定目標的關鍵字。

addNetworkExtrasBundle

@CanIgnoreReturnValue
fun addNetworkExtrasBundle(
    adapterClass: Class<MediationExtrasReceiver!>!,
    networkExtras: Bundle!
): T!

新增額外參數，傳遞至特定廣告聯播網介面卡。

參數
adapterClass: Class<MediationExtrasReceiver!>!	應接收額外內容的轉接程式 Class。
networkExtras: Bundle!	要傳遞至中介服務介面的Bundle額外資訊。

setAdString

@CanIgnoreReturnValue
fun setAdString(adString: String!): T!

設定代表廣告回應的廣告字串。如果設定，SDK 會放送這則廣告，並忽略這項要求中設定的所有其他指定目標資訊。

setContentUrl

@CanIgnoreReturnValue
fun setContentUrl(contentUrl: String!): T!

設定網站的內容網址，該網站的內容與應用程式的主要內容相符。這個網站內容會用於指定目標和品牌安全。

擲回
java.lang.NullPointerException	如果 contentUrl 為 {code null}。
java.lang.IllegalArgumentException	如果 contentUrl 為空，或長度超過 512 個字元。

setHttpTimeoutMillis

@CanIgnoreReturnValue
fun setHttpTimeoutMillis(httpTimeoutMillis: Int): T!

為 Google Mobile Ads SDK 在廣告請求期間發出的 HTTPS 呼叫設定自訂逾時。

如果應用程式使用中介服務，第三方廣告聯播網 SDK 發出的網路呼叫就不會套用這項逾時設定。

參數
httpTimeoutMillis: Int	指定 HTTPS 逾時時間的整數 (以毫秒為單位)。系統會忽略任何低於 5000 (5 秒) 的值。預設值為 60000 (60 秒)。

setNeighboringContentUrls

@CanIgnoreReturnValue
fun setNeighboringContentUrls(
    neighboringContentUrls: (Mutable)List<String!>!
): T!

設定代表廣告附近網頁內容的網址。提升品牌安全，並允許顯示的廣告採用更適合鄰近內容的應用程式分級 (MA、T、PG 等)。

參數
neighboringContentUrls: (Mutable)List<String!>!	要附加至現有鄰近內容網址的鄰近內容網址清單。

setPlacementId

@CanIgnoreReturnValue
fun setPlacementId(placementId: Long): T!

為載入的廣告設定預設刊登位置 ID。

如果是橫幅廣告，建議改用 setPlacementId。使用設定刊登位置 ID 的要求呼叫 loadAd，效果與呼叫 setPlacementId 相同

參數
placementId: Long	AdMob 使用者介面為已設定的刊登位置提供的長整數。

setRequestAgent

@CanIgnoreReturnValue
fun setRequestAgent(requestAgent: String!): T!

設定要求代理程式字串，以識別廣告要求的來源。如果第三方程式庫參照了 Mobile Ads SDK，就應呼叫這個方法，標示廣告請求的來源平台。舉例來說，如果名為「CoolAds network」的第三方廣告聯播網會將請求中介至 Mobile Ads SDK，就應使用「CoolAds」呼叫這個方法。

受保護的函式

self

protected abstract fun self(): T!

傳回指定子類型的自我執行個體。