本頁面由 Cloud Translation API 翻譯而成。

AbstractAdRequestBuilder

Kotlin |Java

public abstract class AbstractAdRequestBuilder<T extends AbstractAdRequestBuilder<T>>

已知的直接子類別

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

用於協助建構廣告請求的基本建構工具類別。

摘要

公用方法
`T`	`@CanIgnoreReturnValue addCustomEventExtrasBundle( Class<CustomEvent> adapterClass, Bundle customEventExtras )` 此方法已淘汰。請改用 `addNetworkExtrasBundle`。
`T`	`@CanIgnoreReturnValue addCustomTargeting(String key, String value)` 新增自訂指定目標參數。
`T`	`@CanIgnoreReturnValue addCustomTargeting(String key, List<String> values)` 新增含有多個值的自訂指定目標參數。
`T`	`@CanIgnoreReturnValue addKeyword(String keyword)` 新增用於指定目標的關鍵字。
`T`	`@CanIgnoreReturnValue addNetworkExtrasBundle( Class<MediationExtrasReceiver> adapterClass, Bundle networkExtras )` 新增額外參數，以便傳遞至特定廣告聯播網轉接程式。
`T`	`@CanIgnoreReturnValue setAdString(String adString)` 設定代表廣告回應的廣告字串。
`T`	`@CanIgnoreReturnValue setContentUrl(String contentUrl)` 為內容與應用程式主要內容相符的網站設定內容網址。
`T`	`@CanIgnoreReturnValue setHttpTimeoutMillis(int httpTimeoutMillis)` 為 Google Mobile Ads SDK 在廣告請求期間發出的 HTTPS 呼叫設定自訂逾時時間。
`T`	`@CanIgnoreReturnValue setNeighboringContentUrls(List<String> neighboringContentUrls)` 設定代表廣告附近網站內容的網址。
`T`	`@CanIgnoreReturnValue setRequestAgent(String requestAgent)` 設定要求代理程式字串，用於識別廣告要求的來源。

受保護的方法
`abstract T`	`self()` 傳回指定子類型的自我例項。

@CanIgnoreReturnValue
public T addCustomEventExtrasBundle(
    Class<CustomEvent> adapterClass,
    Bundle customEventExtras
)

新增額外參數，以便傳遞至特定自訂事件轉接程式。

參數
`Class<CustomEvent> adapterClass`	您提供額外資料的自訂事件轉接程式 `Class`。
`Bundle customEventExtras`	要傳遞至自訂事件轉接器的額外資訊 `Bundle`。

@CanIgnoreReturnValue
public T addCustomTargeting(String key, String value)

新增自訂指定目標參數。如果使用相同的鍵第二次呼叫此方法，系統會覆寫舊值。

@CanIgnoreReturnValue
public T addCustomTargeting(String key, List<String> values)

新增含有多個值的自訂指定目標參數。如果使用相同的鍵第二次呼叫此方法，系統會覆寫舊值。

@CanIgnoreReturnValue
public T addKeyword(String keyword)

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

@CanIgnoreReturnValue
public T addNetworkExtrasBundle(
    Class<MediationExtrasReceiver> adapterClass,
    Bundle networkExtras
)

新增額外參數，以便傳遞至特定廣告聯播網轉接程式。

參數
`Class<MediationExtrasReceiver> adapterClass`	應接收額外資料的轉接程式 `Class`。
`Bundle networkExtras`	要傳遞至中介服務適配器的額外資訊 `Bundle`。

@CanIgnoreReturnValue
public T setAdString(String adString)

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

@CanIgnoreReturnValue
public T setContentUrl(String contentUrl)

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

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

@CanIgnoreReturnValue
public T setHttpTimeoutMillis(int httpTimeoutMillis)

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

如果您的應用程式使用中介服務，則第三方廣告聯播網 SDK 發出的網路呼叫不會受到這項逾時期限的影響。

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

@CanIgnoreReturnValue
public T setNeighboringContentUrls(List<String> neighboringContentUrls)

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

參數
`List<String> neighboringContentUrls`	要附加至現有相鄰內容網址的相鄰內容網址清單。

@CanIgnoreReturnValue
public T setRequestAgent(String requestAgent)

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

protected abstract T self()

傳回指定子類型的自我例項。