AbstractAdRequestBuilder

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

已知的直接子類別

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

摘要

公用方法
T
@CanIgnoreReturnValue
addCustomEventExtrasBundle(
    Class<CustomEvent> adapterClass,
    Bundle customEventExtras
)

這個方法已淘汰。

請改用 addNetworkExtrasBundle。
T

新增自訂指定目標參數。
T

新增具有多個值的自訂指定目標參數。
T

新增用於指定目標的關鍵字。
T
@CanIgnoreReturnValue
addNetworkExtrasBundle(
    Class<MediationExtrasReceiver> adapterClass,
    Bundle networkExtras
)

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

設定代表廣告回應的廣告字串。
T

設定網站的內容網址，該網站的內容與應用程式的主要內容相符。
T

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

設定代表廣告附近網頁內容的網址。
T

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

設定要求代理程式字串，以識別廣告要求的來源。

受保護的方法
abstract T

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

公用方法

addCustomEventExtrasBundle

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

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

參數
Class<CustomEvent> adapterClass

您要提供額外項目的自訂事件轉接程式 Class。
Bundle customEventExtras

要傳遞至自訂事件介面的額外資訊 Bundle。

addCustomTargeting

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

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

addCustomTargeting

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

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

addKeyword

@CanIgnoreReturnValue
public T addKeyword(String keyword)

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

addNetworkExtrasBundle

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

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

參數
Class<MediationExtrasReceiver> adapterClass

應接收額外內容的轉接程式 Class。
Bundle networkExtras

要傳遞至中介服務介面的Bundle額外資訊。

setAdString

@CanIgnoreReturnValue
public T setAdString(String adString)

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

setContentUrl

@CanIgnoreReturnValue
public T setContentUrl(String contentUrl)

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

擲回
java.lang.NullPointerException

如果 contentUrl 為 {code null}。
java.lang.IllegalArgumentException

如果 contentUrl 為空，或長度超過 512 個字元。

setHttpTimeoutMillis

@CanIgnoreReturnValue
public T setHttpTimeoutMillis(int httpTimeoutMillis)

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

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

參數
int httpTimeoutMillis

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

setNeighboringContentUrls

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

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

參數
List<String> neighboringContentUrls

要附加至現有鄰近內容網址的鄰近內容網址清單。

setPlacementId

@CanIgnoreReturnValue
public T setPlacementId(long placementId)

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

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

參數
long placementId

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

setRequestAgent

@CanIgnoreReturnValue
public T setRequestAgent(String requestAgent)

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

受保護的方法

self

protected abstract T self()

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