NativeAd
abstract class NativeAd
Google 原生廣告。
摘要
巢狀型別 |
|---|
abstract class NativeAd.AdChoicesInfo出處資訊。 |
abstract class NativeAd.Image原生廣告圖片素材資源。 |
interface NativeAd.OnNativeAdLoadedListener原生廣告成功載入時叫用的回呼介面定義。 |
interface NativeAd.UnconfirmedClickListener應用程式可使用這個監聽器介面，在啟用「確認點擊」功能時接收未確認的點擊事件。 |
公用建構函式 |
|---|
NativeAd() |
公開函式 |
|
|---|---|
abstract Unit |
取消先前為廣告記錄的未確認點擊。 |
abstract Unit |
destroy()銷毀廣告物件。 |
abstract Unit |
這個函式已淘汰。 |
abstract NativeAd.AdChoicesInfo? |
傳回 AdChoices 歸因資訊。 |
abstract String? |
傳回可識別廣告主的文字。 |
abstract String? |
getBody()傳回內文。 |
abstract String? |
傳回廣告的行動號召 (例如「購買」或「安裝」)。 |
abstract Bundle! |
傳回與原生廣告相關聯的一組額外素材資源。 |
abstract String? |
傳回主要文字廣告標題。 |
abstract NativeAd.Image? |
getIcon()傳回可識別廣告主的圖片。 |
abstract (Mutable)List<NativeAd.Image!>! |
傳回大圖片清單。 |
abstract MediaContent? |
傳回與這個廣告相關聯的 |
abstract (Mutable)List<MuteThisAdReason!>! |
傳回這則廣告可用的「隱藏這則廣告」原因。 |
abstract Long |
傳回這個 |
abstract String? |
getPrice()如果是應用程式廣告，則會傳回代表應用程式費用的字串。 |
abstract ResponseInfo? |
傳回已載入廣告的 |
abstract Double? |
如果是應用程式廣告，則會傳回 0 到 5 星的星級評分，代表應用程式在提供該應用程式的商店中獲得的星數。 |
abstract String? |
getStore()如果是應用程式廣告，則會傳回提供應用程式下載的商店名稱。 |
abstract Boolean |
這個函式已淘汰。 使用 |
abstract Boolean |
如果可以透過程式輔助方式將這則廣告設為靜音，則傳回 |
abstract Unit |
muteThisAd(muteThisAdReason: MuteThisAdReason!)以程式輔助方式隱藏這則廣告。 |
abstract Unit |
performClick(clickData: Bundle!)使用者點按廣告時應呼叫此方法。 |
abstract Unit |
這個函式已淘汰。 Google Mobile Ads SDK 現在會使用 |
abstract Boolean |
recordImpression(impressionData: Bundle!)應在首次顯示廣告時呼叫。 |
abstract Unit |
reportTouchEvent(touchEventData: Bundle!)廣告發生觸控事件時應呼叫。 |
abstract Unit |
setMuteThisAdListener(listener: MuteThisAdListener!)設定廣告的 |
abstract Unit |
setOnPaidEventListener(listener: OnPaidEventListener?)註冊回呼，預估這則廣告有收益時叫用。 |
abstract Unit |
setPlacementId(placementId: Long)設定原生廣告的刊登位置 ID。 |
abstract Unit |
為廣告設定 UnconfirmedClickListener。 |
公用建構函式
公開函式
enableCustomClickGesture
abstract funenableCustomClickGesture(): Unit
發布商可使用這個 NativeAd 的自訂手勢回報點擊次數。廣告單元必須加入許可清單，才能使用這個方法。
根據預設，SDK 會追蹤素材資源檢視區塊的點擊次數。呼叫這個方法後，SDK 就不會再追蹤這個 NativeAd 的點擊次數。應在顯示廣告前呼叫此方法。
getCallToAction
abstract fun getCallToAction(): String?
傳回廣告的行動號召 (例如「購買」或「安裝」)。應用程式不一定要顯示這項素材資源，但建議顯示。
getExtras
abstract fun getExtras(): Bundle!
傳回與原生廣告相關聯的一組額外素材資源。如果中介服務合作夥伴的廣告除了標準素材資源 (價格、商店等) 之外，還有其他素材資源，可以呼叫 setExtras 中的方法進行設定，並透過這個方法擷取。如果是非中介服務流程，則會傳回空白套裝組合。
getMuteThisAdReasons
abstract fun getMuteThisAdReasons(): (Mutable)List<MuteThisAdReason!>!
傳回這則廣告可用的「隱藏這則廣告」原因。使用類別中的文字說明向使用者顯示。
getResponseInfo
abstract fun getResponseInfo(): ResponseInfo?
傳回已載入廣告的 ResponseInfo 物件。廣告未成功載入前會傳回 null。
getStarRating
abstract fun getStarRating(): Double?
如果是應用程式廣告，則會傳回 0 到 5 星的評分，代表應用程式在提供該應用程式的商店中獲得的星數。應用程式不一定要顯示這項素材資源，但建議顯示。
getStore
abstract fun getStore(): String?
如果是應用程式廣告，則會傳回提供應用程式下載的商店名稱。例如「Google Play」。應用程式不一定要顯示這項素材資源，但建議顯示。
isCustomClickGestureEnabled
abstract funisCustomClickGestureEnabled(): Boolean
指出是否可使用自訂點擊手勢回報點擊次數。請與客戶經理聯絡，將廣告單元加入這項功能的允許清單。
isCustomMuteThisAdEnabled
abstract fun isCustomMuteThisAdEnabled(): Boolean
如果可以透過程式輔助方式將這則廣告設為靜音，則傳回 true。使用 setRequestCustomMuteThisAd 要求自訂「隱藏這則廣告」的導入作業。
muteThisAd
abstract fun muteThisAd(muteThisAdReason: MuteThisAdReason!): Unit
以程式輔助方式隱藏這則廣告。
| 參數 | |
|---|---|
muteThisAdReason: MuteThisAdReason! |
使用者選取的靜音原因。從 |
performClick
abstract fun performClick(clickData: Bundle!): Unit
使用者點按廣告時應呼叫此方法。廣告單元必須加入許可清單，才能使用這個 API。這個方法僅適用於 Unity 外掛程式發布商。
| 參數 | |
|---|---|
clickData: Bundle! |
點擊時的應用程式環境組合。如要瞭解如何建構點擊資料 |
recordCustomClickGesture
abstract funrecordCustomClickGesture(): Unit
使用自訂點擊手勢回報這個 NativeAd 的點擊次數。廣告單元必須加入許可清單，才能使用這個方法。
呼叫這個方法前，必須先呼叫 enableCustomClickGesture。
recordImpression
abstract fun recordImpression(impressionData: Bundle!): Boolean
首次顯示廣告時應呼叫此方法。廣告單元必須加入許可清單，才能使用這個 API。
| 參數 | |
|---|---|
impressionData: Bundle! |
曝光發生時的應用程式環境組合。如要瞭解如何建構曝光資料 |
| 傳回 | |
|---|---|
Boolean |
曝光次數是否成功記錄 |
reportTouchEvent
abstract fun reportTouchEvent(touchEventData: Bundle!): Unit
廣告發生觸控事件時應呼叫此方法。廣告單元必須加入許可清單，才能使用這個 API。如有意使用這項功能，請與客戶經理聯絡。
| 參數 | |
|---|---|
touchEventData: Bundle! |
觸控事件座標和時間長度的組合。 touchEventData Bundle 的 JSON 表示法範例： { "x": "100", // The x-coordinate of the touch event relative to the window. "y": "50", // The y-coordinate of the touch event relative to the window. "duration_millis": "500", // The amount of milliseconds the user pressed on the asset. } |
setMuteThisAdListener
abstract fun setMuteThisAdListener(listener: MuteThisAdListener!): Unit
設定廣告的 MuteThisAdListener。
setOnPaidEventListener
abstract fun setOnPaidEventListener(listener: OnPaidEventListener?): Unit
註冊回呼，預估這則廣告有收益時叫用。
setPlacementId
abstract fun setPlacementId(placementId: Long): Unit
設定原生廣告的刊登位置 ID。
為確保報表記錄刊登位置 ID，請在將廣告與 NativeAdView 建立關聯前呼叫這個方法。
| 參數 | |
|---|---|
placementId: Long |
AdMob UI 針對已設定的刊登位置顯示的長整數。 |
setUnconfirmedClickListener
abstract fun setUnconfirmedClickListener(
listener: NativeAd.UnconfirmedClickListener!
): Unit
為廣告設定 UnconfirmedClickListener。