MediationNativeListener

Kotlin |Java

interface MediationNativeListener

---

這個介面已淘汰。

請改用 Adapter 和 MediationAdLoadCallback。

含有轉接程式回呼的監聽器，可向中介服務程式庫回傳通訊。必須將事件回報給中介服務程式庫，才能正確管理廣告流程。

摘要

公開函式
Unit	onAdClicked(adapter: MediationNativeAdapter!) 表示使用者已點按這則廣告。
Unit	onAdClosed(adapter: MediationNativeAdapter!) 指出廣告控制項在全螢幕中算繪了某些內容，現在要將控制權轉移回應用程式。
Unit	onAdFailedToLoad(adapter: MediationNativeAdapter!, adError: AdError) 表示廣告請求無法載入。
Unit	onAdFailedToLoad(adapter: MediationNativeAdapter!, error: Int) 這個函式已淘汰。 請改用 onAdFailedToLoad。
Unit	onAdImpression(adapter: MediationNativeAdapter!) 表示系統已記錄廣告曝光。
Unit	onAdLeftApplication(adapter: MediationNativeAdapter!) 表示廣告導致裝置切換至其他應用程式 (例如網路瀏覽器)。
Unit	onAdLoaded(     adapter: MediationNativeAdapter!,     unifiedNativeAdMapper: UnifiedNativeAdMapper! ) 表示已要求廣告並成功收到。
Unit	onAdOpened(adapter: MediationNativeAdapter!) 表示廣告控制項正在顯示全螢幕內容。
Unit	onVideoEnd(adapter: MediationNativeAdapter!) 表示廣告影片已播放完畢。

公開函式

onAdClicked

fun onAdClicked(adapter: MediationNativeAdapter!): Unit

表示使用者已點按這則廣告。只有在 setOverrideClickHandling 設為 True 時，才應呼叫這個方法。這項事件用於發布商指標，且必須與任何其他事件一併呼叫。

參數
adapter: MediationNativeAdapter!	引發事件的中介服務轉接程式。

onAdClosed

fun onAdClosed(adapter: MediationNativeAdapter!): Unit

指出廣告控制項已在全螢幕中顯示內容，現在要將控制權轉移回應用程式。使用者可能從其他應用程式返回。

請參閱 onAdFailedToLoad。

參數
adapter: MediationNativeAdapter!	引發事件的中介服務轉接程式。

onAdFailedToLoad

fun onAdFailedToLoad(adapter: MediationNativeAdapter!, adError: AdError): Unit

表示廣告請求無法載入。

參數
adapter: MediationNativeAdapter!	引發事件的中介服務轉接程式。
adError: AdError	詳述失敗原因的 AdError。

另請參閱
onAdLoaded

onAdFailedToLoad

fun onAdFailedToLoad(adapter: MediationNativeAdapter!, error: Int): Unit

這個函式已淘汰。

請改用 onAdFailedToLoad。

表示廣告請求失敗，並顯示根本原因。失敗可能是實際發生錯誤，也可能只是缺少填寫內容。

要求廣告後，轉接程式必須回報成功或失敗。如果在時限內沒有收到回應，中介服務程式庫可能會改用其他轉接程式，導致可能成功的廣告無法顯示。

參數
adapter: MediationNativeAdapter!	引發事件的中介服務轉接程式。
error: Int	詳述失敗原因的錯誤代碼。

另請參閱
onAdLoaded

onAdImpression

fun onAdImpression(adapter: MediationNativeAdapter!): Unit

表示系統已記錄廣告曝光次數。只有在 setOverrideImpressionRecording 設為 True 時，才應呼叫這個方法。這項事件用於發布商指標，且必須與任何其他事件一併呼叫。

參數
adapter: MediationNativeAdapter!	引發事件的中介服務轉接程式。

onAdLeftApplication

fun onAdLeftApplication(adapter: MediationNativeAdapter!): Unit

表示廣告導致裝置切換至其他應用程式 (例如網路瀏覽器)。必須在目前應用程式進入背景前呼叫這個方法。

參數
adapter: MediationNativeAdapter!	引發事件的中介服務轉接程式。

onAdLoaded

fun onAdLoaded(
    adapter: MediationNativeAdapter!,
    unifiedNativeAdMapper: UnifiedNativeAdMapper!
): Unit

表示已要求廣告並成功收到。

要求廣告後，轉接程式必須回報成功或失敗。如果在時限內沒有收到回應，中介服務程式庫可能會改用其他轉接程式，導致可能成功的廣告無法顯示。

請參閱 onAdFailedToLoad。

參數
adapter: MediationNativeAdapter!	引發事件的中介服務轉接程式。
unifiedNativeAdMapper: UnifiedNativeAdMapper!	對應類別，可將中介廣告聯播網的廣告物件對應至整合式原生廣告物件。

onAdOpened

fun onAdOpened(adapter: MediationNativeAdapter!): Unit

表示廣告控制項正在顯示全螢幕內容。這可能是 android.app.Activity，也可能是切換至其他應用程式的前置作業。

關閉這個畫面後，必須呼叫 onAdClosed。

參數
adapter: MediationNativeAdapter!	引發事件的中介服務轉接程式。

onVideoEnd

fun onVideoEnd(adapter: MediationNativeAdapter!): Unit

表示廣告影片已播放完畢。

參數
adapter: MediationNativeAdapter!	引發事件的中介服務轉接程式。