NativeCustomFormatAd

Kotlin |Java

public interface NativeCustomFormatAd

---

Ad Manager 自訂原生廣告格式。自訂 (使用者定義) 原生廣告格式可讓您自行定義傳統原生廣告變數。自訂原生廣告格式可讓您定義及顯示自己的素材資源，並定義廣告的點擊行為。

摘要

巢狀類型
public interface NativeCustomFormatAd.DisplayOpenMeasurement 多媒體廣告中的開放式評估介面。
public interface NativeCustomFormatAd.OnCustomClickListener 使用者點選自訂原生廣告格式時，系統會叫用回呼的介面定義。
public interface NativeCustomFormatAd.OnCustomFormatAdLoadedListener 在自訂原生廣告格式成功載入時，要叫用的回呼介面定義。

常數
default static final String	ASSET_NAME_VIDEO = "_videoMediaView" 與 getMediaContent 傳回的影片內容相關聯的素材資源名稱。

公用方法
abstract void	destroy() 銷毀廣告物件。
abstract @Nullable List<String>	getAvailableAssetNames() 傳回所有可用素材資源的清單。
abstract @Nullable String	getCustomFormatId() 傳回 Ad Manager UI 中定義的自訂原生廣告格式 ID。
abstract NativeCustomFormatAd.DisplayOpenMeasurement	getDisplayOpenMeasurement() 傳回與此廣告相關聯的 DisplayOpenMeasurement。
abstract @Nullable NativeAd.Image	getImage(String assetName) 傳回圖片素材資源。
abstract @Nullable MediaContent	getMediaContent() 傳回與此廣告相關聯的 MediaContent。
abstract @Nullable CharSequence	getText(String assetName) 傳回數字、網址或其他類型的字串素材資源 (不含圖片素材資源)。
abstract void	performClick(String assetName) 執行廣告點擊，執行點擊後行為。
abstract void	recordImpression() 記錄曝光次數。

常數

ASSET_NAME_VIDEO

default static final String ASSET_NAME_VIDEO = "_videoMediaView"

與 getMediaContent 所傳回影片內容相關聯的素材資源名稱。當使用者點選包含 getMediaContent 所傳回影片內容的 MediaView 時，系統會在 onCustomClick 中回報這個資產名稱。

公用方法

destroy

abstract void destroy()

摧毀廣告物件。呼叫 destroy 後，請勿在廣告物件上呼叫其他方法。

getAvailableAssetNames

abstract @Nullable List<String> getAvailableAssetNames()

傳回所有可用素材資源的清單。

傳回
@Nullable List<String>	所有可用資產的清單，如果沒有可用資產，則為空白清單。

getCustomFormatId

abstract @Nullable String getCustomFormatId()

傳回 Ad Manager UI 中定義的自訂原生廣告格式 ID。

getDisplayOpenMeasurement

abstract NativeCustomFormatAd.DisplayOpenMeasurement getDisplayOpenMeasurement()

傳回與此廣告相關聯的 DisplayOpenMeasurement。

傳回
NativeCustomFormatAd.DisplayOpenMeasurement	null：如果這則廣告無法使用顯示開啟評估。

getImage

abstract @Nullable NativeAd.Image getImage(String assetName)

傳回圖片素材資源。

參數
String assetName	要擷取的素材資源名稱。

傳回
@Nullable NativeAd.Image	具有素材資源名稱的素材資源值，如果沒有此素材資源名稱，則為空值。

getMediaContent

abstract @Nullable MediaContent getMediaContent()

傳回與此廣告相關聯的 MediaContent。

getText

abstract @Nullable CharSequence getText(String assetName)

傳回數字、網址或其他類型 (不含圖片素材資源) 的字串素材資源。

參數
String assetName	要擷取的素材資源名稱。

傳回
@Nullable CharSequence	具有素材資源名稱的素材資源值，如果沒有此素材資源名稱，則為空值。

performClick

abstract void performClick(String assetName)

執行廣告點擊，執行點擊後行為。

參數
String assetName	獲得點擊的素材資源名稱。

recordImpression

abstract void recordImpression()

記錄曝光次數。在首次向使用者顯示廣告時呼叫此方法。