AdLoader.Builder

Kotlin |Java

public class AdLoader.Builder

---

AdLoader 的建構工具。

摘要

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

公用方法
AdLoader	build() 如果發生錯誤，就會傳回 AdLoader 或空值。
AdLoader.Builder	@CanIgnoreReturnValue forAdManagerAdView(     @NonNull OnAdManagerAdViewLoadedListener listener,     AdSize[] adSizes ) 註冊事件監聽器，以便處理 Google Ad Manager 橫幅廣告的載入作業。
AdLoader.Builder	@CanIgnoreReturnValue forCustomFormatAd(     String customFormatId,     NativeCustomFormatAd.OnCustomFormatAdLoadedListener adLoadedListener,     @Nullable NativeCustomFormatAd.OnCustomClickListener customClickListener ) 讓 AdLoader 載入自訂格式廣告。
AdLoader.Builder	@CanIgnoreReturnValue forNativeAd(NativeAd.OnNativeAdLoadedListener listener) 註冊事件監聽器，以便處理 NativeAd 的載入作業。
AdLoader.Builder	@CanIgnoreReturnValue withAdListener(AdListener listener)
AdLoader.Builder	@CanIgnoreReturnValue withAdManagerAdViewOptions(AdManagerAdViewOptions options) 設定用於載入 Google Ad Manager 廣告檢視畫面的選項。
AdLoader.Builder	@CanIgnoreReturnValue withNativeAdOptions(NativeAdOptions options) 將原生廣告選項設為廣告載入器建構工具。

公用建構函式

Builder

public Builder(Context context, String adUnitID)

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

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

公用方法

build

public AdLoader build()

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

forAdManagerAdView

@CanIgnoreReturnValue
public AdLoader.Builder forAdManagerAdView(
    @NonNull OnAdManagerAdViewLoadedListener listener,
    AdSize[] adSizes
)

註冊事件監聽器，以便處理 Google Ad Manager 橫幅廣告的載入作業。

參數
@NonNull OnAdManagerAdViewLoadedListener listener	橫幅廣告載入時執行的回呼。
AdSize[] adSizes	設定橫幅廣告支援的大小。

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

forCustomFormatAd

@CanIgnoreReturnValue
public AdLoader.Builder forCustomFormatAd(
    String customFormatId,
    NativeCustomFormatAd.OnCustomFormatAdLoadedListener adLoadedListener,
    @Nullable NativeCustomFormatAd.OnCustomClickListener customClickListener
)

讓 AdLoader 載入自訂格式廣告。

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

forNativeAd

@CanIgnoreReturnValue
public AdLoader.Builder forNativeAd(NativeAd.OnNativeAdLoadedListener listener)

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

參數
NativeAd.OnNativeAdLoadedListener listener	NativeAd 載入時要呼叫的事件監聽器。

withAdListener

@CanIgnoreReturnValue
public AdLoader.Builder withAdListener(AdListener listener)

參數
AdListener listener	擷取原生廣告時發生錯誤時，會處理這些錯誤的物件。

withAdManagerAdViewOptions

@CanIgnoreReturnValue
public AdLoader.Builder withAdManagerAdViewOptions(AdManagerAdViewOptions options)

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

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

withNativeAdOptions

@CanIgnoreReturnValue
public AdLoader.Builder withNativeAdOptions(NativeAdOptions options)

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

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