NativeAd

public abstract class NativeAd


Google 原生廣告。

摘要

巢狀型別

public abstract class NativeAd.AdChoicesInfo

作者資訊。

public abstract class NativeAd.Image

原生廣告圖片素材資源。

原生廣告成功載入時要呼叫的回呼介面定義。

應用程式可使用這個監聽器介面,在啟用「確認點擊」功能時接收未確認的點擊事件。

公用建構函式

公用方法

abstract void

取消先前為廣告記錄的未確認點擊。

abstract void

銷毀廣告物件。

abstract void

這個方法已淘汰。

使用 enableCustomClickGestureDirection

abstract @Nullable NativeAd.AdChoicesInfo

傳回 AdChoices 出處資訊。

abstract @Nullable String

傳回可識別廣告主的文字。

abstract @Nullable String

傳回內文。

abstract @Nullable String

傳回廣告的行動號召 (例如「購買」或「安裝」)。

abstract Bundle

傳回與原生廣告相關聯的一組額外素材資源。

abstract @Nullable String

傳回主要文字廣告標題。

abstract @Nullable NativeAd.Image

傳回可識別廣告主的圖片。

abstract List<NativeAd.Image>

傳回大型圖片清單。

abstract @Nullable MediaContent

傳回與這個廣告相關聯的 MediaContent

abstract List<MuteThisAdReason>

傳回這則廣告可用的「關閉這則廣告」原因。

abstract long

傳回這個 NativeAd 的刊登位置 ID。

abstract @Nullable String

如果是應用程式廣告,則會傳回代表應用程式費用的字串。

abstract @Nullable ResponseInfo

傳回已載入廣告的 ResponseInfo 物件。

abstract @Nullable Double

如果是應用程式廣告,則會傳回 0 到 5 星的星級評分,代表應用程式在提供該應用程式的商店中獲得的星數。

abstract @Nullable String

如果是應用程式廣告,則會傳回提供應用程式下載的商店名稱。

abstract boolean

這個方法已淘汰。

使用 enableCustomClickGestureDirection 載入廣告時,系統傳回的所有廣告都會支援自訂點擊手勢。

abstract boolean

如果可以透過程式輔助方式將這則廣告設為靜音,則傳回 true

abstract void
muteThisAd(MuteThisAdReason muteThisAdReason)

以程式輔助方式隱藏這則廣告。

abstract void
performClick(Bundle clickData)

使用者點按廣告時應呼叫此方法。

abstract void

這個方法已淘汰。

Google Mobile Ads SDK 現在會使用 enableCustomClickGestureDirection 中要求的點擊手勢方向,追蹤自訂點擊手勢。

abstract boolean
recordImpression(Bundle impressionData)

首次顯示廣告時應呼叫此方法。

abstract void
reportTouchEvent(Bundle touchEventData)

廣告發生觸控事件時應呼叫。

abstract void

設定廣告的 MuteThisAdListener

abstract void

註冊回呼,在預估這則廣告已賺取收益時叫用。

abstract void
setPlacementId(long placementId)

設定原生廣告的刊登位置 ID。

abstract void

為廣告設定 UnconfirmedClickListener。

公用建構函式

NativeAd

public NativeAd()

公用方法

cancelUnconfirmedClick

public abstract void cancelUnconfirmedClick()

取消先前為廣告記錄的未確認點擊。

destroy

public abstract void destroy()

銷毀廣告物件。呼叫 destroy 後,不應對廣告物件呼叫其他方法。

enableCustomClickGesture

public abstract void enableCustomClickGesture()

發布商可使用這個 NativeAd 的自訂手勢回報點擊次數。廣告單元必須加入許可清單,才能使用這個方法。

根據預設,SDK 會追蹤素材資源檢視畫面的點擊次數。呼叫這個方法後,SDK 就不會再追蹤這個 NativeAd 的點擊次數。應在顯示廣告前呼叫此方法。

getAdChoicesInfo

public abstract @Nullable NativeAd.AdChoicesInfo getAdChoicesInfo()

傳回 AdChoices 出處資訊。

getAdvertiser

public abstract @Nullable String getAdvertiser()

傳回可識別廣告主的文字。應用程式不一定要顯示這項素材資源,但建議顯示。

getBody

public abstract @Nullable String getBody()

傳回內文。應用程式必須顯示這項素材資源。

getCallToAction

public abstract @Nullable String getCallToAction()

傳回廣告的行動號召 (例如「購買」或「安裝」)。應用程式不一定要顯示這項素材資源,但建議顯示。

getExtras

public abstract Bundle getExtras()

傳回與原生廣告相關聯的一組額外素材資源。如果中介服務合作夥伴的廣告除了標準素材資源 (價格、商店等) 之外,還有其他素材資源,可以呼叫 setExtras 中的方法進行設定,並透過這個方法擷取。如果是非中介服務流程,則會傳回空白套裝組合。

getHeadline

public abstract @Nullable String getHeadline()

傳回主要文字廣告標題。應用程式必須顯示這項素材資源。

getIcon

public abstract @Nullable NativeAd.Image getIcon()

傳回可識別廣告主的圖片。應用程式不一定要顯示這項素材資源,但建議顯示。

getImages

public abstract List<NativeAd.ImagegetImages()

傳回大圖片清單。應用程式不一定要顯示這項素材資源,但建議顯示。

getMediaContent

public abstract @Nullable MediaContent getMediaContent()

傳回與這個廣告相關聯的 MediaContent

getMuteThisAdReasons

public abstract List<MuteThisAdReasongetMuteThisAdReasons()

傳回這則廣告可用的「關閉這則廣告」原因。使用類別中的文字說明向使用者顯示。

getPlacementId

public abstract long getPlacementId()

傳回這個 NativeAd 的刊登位置 ID。

getPrice

public abstract @Nullable String getPrice()

如果是應用程式廣告,則會傳回代表應用程式費用的字串。應用程式不一定要顯示這項素材資源,但建議顯示。

getResponseInfo

public abstract @Nullable ResponseInfo getResponseInfo()

傳回已載入廣告的 ResponseInfo 物件。廣告成功載入前,會傳回 null

getStarRating

public abstract @Nullable Double getStarRating()

如果是應用程式廣告,則會傳回 0 到 5 星的星級評分,代表應用程式在提供該應用程式的商店中獲得的星數。應用程式不一定要顯示這項素材資源,但建議顯示。

getStore

public abstract @Nullable String getStore()

如果是應用程式廣告,則會傳回提供應用程式下載的商店名稱。例如「Google Play」。應用程式不一定要顯示這項素材資源,但建議顯示。

isCustomClickGestureEnabled

public abstract boolean isCustomClickGestureEnabled()

指出是否可使用自訂點擊手勢回報點擊。請與客戶經理聯絡,將廣告單元加入這項功能的允許清單。

isCustomMuteThisAdEnabled

public abstract boolean isCustomMuteThisAdEnabled()

如果可以透過程式輔助方式將這則廣告設為靜音,則傳回 true。使用 setRequestCustomMuteThisAd 要求自訂導入「隱藏這則廣告」。

muteThisAd

public abstract void muteThisAd(MuteThisAdReason muteThisAdReason)

以程式輔助方式隱藏這則廣告。

參數
MuteThisAdReason muteThisAdReason

使用者選取的靜音原因。從 getMuteThisAdReasons 取得靜音原因。使用 null 即可透過預設原因關閉這則廣告。

performClick

public abstract void performClick(Bundle clickData)

使用者點按廣告時應呼叫此方法。廣告單元必須加入許可清單,才能使用這個 API。這個方法僅適用於 Unity 外掛程式發布商。

參數
Bundle clickData

點擊時的應用程式環境組合。如要瞭解如何建構點擊資料 Bundle,請參閱NativeAdConstants

recordCustomClickGesture

public abstract void recordCustomClickGesture()

使用自訂點擊手勢回報這個 NativeAd 的點擊次數。廣告單元必須加入許可清單,才能使用這個方法。

呼叫這個方法前,必須先呼叫 enableCustomClickGesture

recordImpression

public abstract boolean recordImpression(Bundle impressionData)

首次顯示廣告時應呼叫此方法。廣告單元必須加入許可清單,才能使用這個 API。

參數
Bundle impressionData

曝光發生時的應用程式環境組合。如要瞭解如何建構點擊資料 Bundle,請參閱NativeAdConstants

傳回
boolean

曝光次數是否成功記錄

reportTouchEvent

public abstract void reportTouchEvent(Bundle touchEventData)

廣告發生觸控事件時應呼叫此方法。廣告單元必須加入許可清單,才能使用這個 API。如有意使用這項功能,請與客戶經理聯絡。

參數
Bundle touchEventData

觸控事件座標和時間長度的組合。

touchEventData 組合的 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

public abstract void setMuteThisAdListener(MuteThisAdListener listener)

設定廣告的 MuteThisAdListener

setOnPaidEventListener

public abstract void setOnPaidEventListener(@Nullable OnPaidEventListener listener)

註冊回呼,在預估這則廣告已賺取收益時叫用。

setPlacementId

public abstract void setPlacementId(long placementId)

設定原生廣告的刊登位置 ID。

為確保報表包含這個刊登位置 ID,請在將廣告與 NativeAdView 建立關聯前呼叫這個方法。

參數
long placementId

AdMob 使用者介面為已設定的刊登位置提供的長整數。

setUnconfirmedClickListener

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

為廣告設定 UnconfirmedClickListener。