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!

要求自訂事件插頁式廣告的 com.google.android.gms.ads.interstitial.InterstitialAd Context。建議使用 android.app.Activity

listener: CustomEventInterstitialListener!

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

serverParameter: String?

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

mediationAdRequest: MediationAdRequest!

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

customEventExtras: Bundle?

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

showInterstitial

fun showInterstitial(): Unit

顯示插頁式廣告。呼叫 onAdLoaded 後,隨時可以呼叫這個方法。