CustomEventInterstitial

interface CustomEventInterstitial : CustomEvent


支援插頁式廣告的自訂事件。

自訂事件的一般生命週期是呼叫 requestInterstitialAd 一次。此時,轉接程式應要求廣告,並向監聽器回報 onAdLoaded 或 onAdFailedToLoad。後續要求會使用自訂事件的新例項。在生命週期結束時,系統會盡力呼叫 onDestroy,但不保證一定能成功。請注意,requestInterstitialAd 會在 UI 執行緒上呼叫,因此在該執行緒上編寫程式碼時,必須採取所有標準的預防措施。具體來說,程式碼不應呼叫任何阻斷方法。

自訂事件應透過 requestInterstitialAd 呼叫中傳遞的 CustomEventInterstitialListener 轉送事件。請在 serverParameterMediationAdRequest customEventExtras 參數中傳遞所有廣告請求所需的參數。

摘要

公開函式

Unit
requestInterstitialAd(
    context: Context!,
    listener: CustomEventInterstitialListener!,
    serverParameter: String?,
    mediationAdRequest: MediationAdRequest!,
    customEventExtras: Bundle?
)

由中介服務程式庫呼叫,用於要求插頁式廣告。

Unit

顯示插頁式廣告。

繼承的函式

來自 com.google.android.gms.ads.mediation.customevent.CustomEvent
Unit

拆解轉接器控制項。

Unit

在應用程式呼叫 pause 時呼叫。

Unit

在應用程式呼叫 resume 時呼叫。

公開函式

requestInterstitialAd

fun requestInterstitialAd(
    context: Context!,
    listener: CustomEventInterstitialListener!,
    serverParameter: String?,
    mediationAdRequest: MediationAdRequest!,
    customEventExtras: Bundle?
): Unit

由中介服務程式庫呼叫,用於要求插頁式廣告。

如果要求成功,應呼叫 onAdLoaded

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

此方法會在 UI 執行緒上呼叫,因此會套用在該執行緒上編寫程式碼的所有標準預防措施。特別是,您的程式碼不應呼叫任何封鎖方法。

參數
context: Context!

要求自訂事件插頁式廣告的 Context。建議使用 android.app.Activity

listener: CustomEventInterstitialListener!

自訂事件的監聽器,可用於各種事件的回呼。

serverParameter: String?

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

mediationAdRequest: MediationAdRequest!

請求插頁式廣告時使用的泛型指定目標參數。

customEventExtras: Bundle?

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

showInterstitial

fun showInterstitial(): Unit

顯示插頁式廣告。這個方法可以在呼叫 onAdLoaded 後的任何時間呼叫。