AdLoader.Builder

Kotlin |Java

class AdLoader.Builder

AdLoader 的建構工具。

摘要

公用建構函式
`Builder(context: Context!, adUnitID: String!)` 建立新的 `Builder`，用於建構 `AdLoader`。

公開函式
`AdLoader!`	`build()` 如果發生錯誤，則會傳回 `AdLoader` 或空值。
`AdLoader.Builder!`	`@CanIgnoreReturnValue forAdManagerAdView( listener: OnAdManagerAdViewLoadedListener, adSizes: Array<AdSize!>! )` 註冊監聽器，處理載入 Google Ad Manager 橫幅廣告。
`AdLoader.Builder!`	`@CanIgnoreReturnValue forCustomFormatAd( customFormatId: String!, adLoadedListener: NativeCustomFormatAd.OnCustomFormatAdLoadedListener!, customClickListener: NativeCustomFormatAd.OnCustomClickListener? )` 啟用 `AdLoader`，載入自訂格式廣告。
`AdLoader.Builder!`	`@CanIgnoreReturnValue forNativeAd(listener: NativeAd.OnNativeAdLoadedListener!)` 註冊事件監聽器，以處理 `NativeAd` 的載入作業。
`AdLoader.Builder!`	`@CanIgnoreReturnValue withAdListener(listener: AdListener!)`
`AdLoader.Builder!`	`@CanIgnoreReturnValue withAdManagerAdViewOptions(options: AdManagerAdViewOptions!)` 設定用於載入 Google Ad Manager 廣告檢視區塊的選項。
`AdLoader.Builder!`	`@CanIgnoreReturnValue withNativeAdOptions(options: NativeAdOptions!)` 將原生廣告選項設為廣告載入器建構工具。

公用建構函式

Builder

Builder(context: Context!, adUnitID: String!)

建立新的 Builder，用於建構 AdLoader。

參數
`context: Context!`	背景資訊。
`adUnitID: String!`	廣告單元 ID。

公開函式

build

fun build(): AdLoader!

如果發生錯誤，則會傳回 AdLoader 或空值。

forAdManagerAdView

@CanIgnoreReturnValue
fun forAdManagerAdView(
    listener: OnAdManagerAdViewLoadedListener,
    adSizes: Array<AdSize!>!
): AdLoader.Builder!

註冊監聽器，處理載入 Google Ad Manager 橫幅廣告。

參數
`listener: OnAdManagerAdViewLoadedListener`	橫幅廣告載入時執行的回呼。
`adSizes: Array<AdSize!>!`	設定橫幅廣告支援的大小。

擲回
`java.lang.IllegalArgumentException`	如果 `adSizes` 為 `null` 或空白。

forCustomFormatAd

@CanIgnoreReturnValue
fun forCustomFormatAd(
    customFormatId: String!,
    adLoadedListener: NativeCustomFormatAd.OnCustomFormatAdLoadedListener!,
    customClickListener: NativeCustomFormatAd.OnCustomClickListener?
): AdLoader.Builder!

啟用 AdLoader，載入自訂格式廣告。

參數
`customFormatId: String!`	在 Ad Manager 使用者介面中定義的自訂格式 ID。
`adLoadedListener: NativeCustomFormatAd.OnCustomFormatAdLoadedListener!`	`NativeCustomFormatAd` 載入時要呼叫的接聽器。
`customClickListener: NativeCustomFormatAd.OnCustomClickListener?`	選用監聽器，可定義廣告點擊的自訂點擊邏輯。設定後，系統會覆寫廣告的預設點擊行為，也就是前往 Ad Manager 使用者介面中定義的點擊網址。

forNativeAd

@CanIgnoreReturnValue
fun forNativeAd(listener: NativeAd.OnNativeAdLoadedListener!): AdLoader.Builder!

註冊事件監聽器，以處理 NativeAd 的載入作業。

參數
`listener: NativeAd.OnNativeAdLoadedListener!`	`NativeAd` 載入時要呼叫的接聽器。

withAdListener

@CanIgnoreReturnValue
fun withAdListener(listener: AdListener!): AdLoader.Builder!

參數
`listener: AdListener!`	這個物件會處理擷取原生廣告時發生的錯誤。

withAdManagerAdViewOptions

@CanIgnoreReturnValue
fun withAdManagerAdViewOptions(options: AdManagerAdViewOptions!): AdLoader.Builder!

設定用於載入 Google Ad Manager 廣告檢視區塊的選項。

參數
`options: AdManagerAdViewOptions!`	Google Ad Manager 橫幅廣告選項。

withNativeAdOptions

@CanIgnoreReturnValue
fun withNativeAdOptions(options: NativeAdOptions!): AdLoader.Builder!

將原生廣告選項設為廣告載入器建構工具。

參數
`options: NativeAdOptions!`	指定各種原生廣告選項的物件。