MediationBannerAdapter

public interface MediationBannerAdapter extends MediationAdapter


支援橫幅廣告的第三方廣告聯播網專用轉接程式。

轉接程式的典型生命週期是呼叫 requestBannerAd 一次。此時,轉接程式應向廣告聯播網請求廣告,並透過 onAdLoaded 或 onAdFailedToLoad 回報給事件監聽器。後續要求會使用新的轉接程式執行個體。在生命週期結束時,系統會盡力呼叫 onDestroy,但無法保證一定會成功。請注意,requestBannerAd 是在 UI 執行緒上呼叫,因此適用於在該執行緒上編寫程式碼的所有標準預防措施。具體來說,程式碼不應呼叫任何封鎖方法。

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

介面卡應盡量在用戶端停用自動重新整理廣告功能。系統可能會忽略重新整理的廣告、不顯示廣告,並錯誤計算廣告。

摘要

公用方法

abstract View

傳回可顯示廣告的 View

abstract void
requestBannerAd(
    Context context,
    MediationBannerListener listener,
    Bundle serverParameters,
    AdSize adSize,
    MediationAdRequest mediationAdRequest,
    @Nullable Bundle mediationExtras
)

中介服務資料庫會呼叫此方法,向轉接程式請求橫幅廣告。

繼承方法

來自 com.google.android.gms.ads.mediation.MediationAdapter
abstract void

拆除轉接頭控制項。

abstract void

應用程式在 com.google.android.gms.ads.AdView 上呼叫 onPause 時呼叫。

abstract void

應用程式在 com.google.android.gms.ads.AdView 上呼叫 onResume 時呼叫。

公用方法

getBannerView

abstract View getBannerView()

傳回可顯示廣告的 View

requestBannerAd 呼叫後和 onDestroy 呼叫前,這個值不得為空值。其他時間可能為空值。

requestBannerAd

abstract void requestBannerAd(
    Context context,
    MediationBannerListener listener,
    Bundle serverParameters,
    AdSize adSize,
    MediationAdRequest mediationAdRequest,
    @Nullable Bundle mediationExtras
)

中介服務程式庫會呼叫此方法,向轉接程式請求橫幅廣告。

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

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

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

參數
Context context

AdView 的 Context,其中會包含橫幅 View。建議使用 android.app.Activity

MediationBannerListener listener

轉接程式的監聽器,其中包含各種事件的回呼

Bundle serverParameters

發布商在中介服務伺服器端定義的其他參數

AdSize adSize

要擷取的廣告大小。傳回的廣告大小應盡可能接近這個參數指定的大小。如果系統不支援這個廣告大小,要求應會失敗,並呼叫 onAdFailedToLoad。

MediationAdRequest mediationAdRequest

發布商在提出廣告請求時使用的通用參數

@Nullable Bundle mediationExtras

發布商針對每項要求設定的其他參數