MediationNativeListener

Kotlin |Java

public interface MediationNativeListener

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

摘要

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

abstract void onAdClicked(MediationNativeAdapter adapter)

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

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

abstract void onAdClosed(MediationNativeAdapter adapter)

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

請參閱 onAdFailedToLoad。

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

abstract void onAdFailedToLoad(
    MediationNativeAdapter adapter,
    @NonNull AdError adError
)

表示廣告請求無法載入。

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

另請參閱
`onAdLoaded`

abstract void onAdFailedToLoad(MediationNativeAdapter adapter, int error)

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

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

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

另請參閱
`onAdLoaded`

abstract void onAdImpression(MediationNativeAdapter adapter)

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

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

abstract void onAdLeftApplication(MediationNativeAdapter adapter)

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

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

abstract void onAdLoaded(
    MediationNativeAdapter adapter,
    UnifiedNativeAdMapper unifiedNativeAdMapper
)

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

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

請參閱 onAdFailedToLoad。

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

abstract void onAdOpened(MediationNativeAdapter adapter)

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

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

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

abstract void onVideoEnd(MediationNativeAdapter adapter)

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

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