CustomEventBanner

public interface CustomEventBanner extends CustomEvent


支援橫幅廣告的自訂事件。

自訂事件的典型生命週期是呼叫 requestBannerAd 一次。此時,轉接程式應建立 android.view.View,並向 CustomEventBannerListener 回報 onAdLoaded 或 onAdFailedToLoad。後續要求會使用新的自訂事件例項。在生命週期結束時,系統會盡力呼叫 onDestroy,但無法保證一定會成功。請注意,requestBannerAd 是在 UI 執行緒上呼叫,因此適用於在該執行緒上編寫程式碼的所有標準預防措施。具體來說,程式碼不應呼叫任何封鎖方法。

介面卡應透過 requestBannerAd 呼叫中傳遞的 CustomEventBannerListener 公開事件。所有製作廣告請求所需的參數,都應傳遞至 serverParameterMediationAdRequestcustomEventExtras 參數。

摘要

公用方法

abstract void
requestBannerAd(
    Context context,
    CustomEventBannerListener listener,
    @Nullable String serverParameter,
    AdSize size,
    MediationAdRequest mediationAdRequest,
    @Nullable Bundle customEventExtras
)

中介服務程式庫會呼叫這個方法,要求自訂事件提供檢視區塊。

繼承方法

來自 com.google.android.gms.ads.mediation.customevent.CustomEvent
abstract void

拆除轉接頭控制項。

abstract void

應用程式呼叫 pause 時呼叫。

abstract void

應用程式呼叫 resume 時呼叫。

公用方法

requestBannerAd

abstract void requestBannerAd(
    Context context,
    CustomEventBannerListener listener,
    @Nullable String serverParameter,
    AdSize size,
    MediationAdRequest mediationAdRequest,
    @Nullable Bundle customEventExtras
)

中介服務程式庫會呼叫這個方法,要求自訂事件提供檢視區塊。

如果要求成功,系統應會呼叫 onAdLoaded

如果要求失敗,系統應在 listener 上呼叫 onAdFailedToLoad,並提供適當的錯誤原因。

這個方法會在 UI 執行緒上呼叫,因此請務必遵守在該執行緒上編寫程式碼的所有標準預防措施。具體來說,您的程式碼不應呼叫任何封鎖方法。

參數
Context context

AdView 的 Context,其中會包含自訂事件 android.view.View。建議使用 android.app.Activity

CustomEventBannerListener listener

監聽自訂事件,並為各種事件提供回呼。

@Nullable String serverParameter

在發布商使用者介面中設定的字串,做為自訂事件的參數。

AdSize size

要擷取的檢視畫面大小。檢視區塊的大小應盡量接近這個參數中指定的大小。如果系統不支援這個檢視區塊大小,要求應會失敗,並呼叫 onAdFailedToLoad。

MediationAdRequest mediationAdRequest

要求檢視畫面時要使用的通用指定目標參數。

@Nullable Bundle customEventExtras

發布商針對個別要求設定的 Bundle 參數。