如要討論產品並提供意見，請加入 Google 廣告與評估社群伺服器中的官方 AdMob Discord 頻道。

本頁面由 Cloud Translation API 翻譯而成。

UnifiedNativeAdMapper

Kotlin |Java

public abstract class UnifiedNativeAdMapper

為 Google AdMob 統一原生廣告對應的類別。

載入原生廣告的中介服務轉接程式必須擴充這個類別，以便將中介廣告聯播網的原生廣告物件對應至。

摘要

公開欄位
`View`	`adChoicesContent`
`String`	`advertiser`
`String`	`body`
`String`	`callToAction`
`Bundle`	`extras`
`String`	`headline`
`NativeAd.Image`	`icon`
`List<NativeAd.Image>`	`images`
`float`	`mediaContentAspectRatio`
`boolean`	`overrideClickHandling`
`boolean`	`overrideImpressionRecording`
`String`	`price`
`Double`	`starRating`
`String`	`store`

公用建構函式
`UnifiedNativeAdMapper()`

公用方法
`View`	`getAdChoicesContent()` 傳回用於 AdChoices 內容的檢視畫面。
`final String`	`getAdvertiser()` 傳回用來識別廣告主的文字。
`final String`	`getBody()` 傳回內文。
`final String`	`getCallToAction()` 傳回鼓勵使用者採取行動的文字。
`float`	`getCurrentTime()` 取得影片目前的時間。
`float`	`getDuration()` 取得影片的片長。
`final Bundle`	`getExtras()` 傳回透過 setExtras 方法傳入的額外項目組合。
`final String`	`getHeadline()` 傳回主要文字標題。
`final NativeAd.Image`	`getIcon()` 傳回可識別廣告主的縮圖。
`final List<NativeAd.Image>`	`getImages()` 傳回大型圖片的清單。
`float`	`getMediaContentAspectRatio()` 傳回要在 `MediaView` 中算繪的媒體的顯示比例。
`final boolean`	`getOverrideClickHandling()` 如果廣告聯播網自行處理點擊，則傳回 true。
`final boolean`	`getOverrideImpressionRecording()` 如果廣告聯播網自行進行曝光追蹤，則傳回 true。
`final String`	`getPrice()` 如果是應用程式廣告，則傳回字串，代表應用程式的價格。
`final Double`	`getStarRating()` 如果是應用程式廣告，則會傳回星級評等 (0 到 5 顆星)，代表應用程式在提供該應用程式的商店中獲得的星級。
`final String`	`getStore()` 如果是應用程式廣告，則會傳回提供應用程式供下載的應用程式商店名稱。
`void`	`handleClick(View view)` 如果網路要求開發人員明確處理顯示在螢幕上的檢視區塊點擊事件，子類別應實作此方法。
`boolean`	`hasVideoContent()` 如果目前的廣告含有影片內容，則傳回 true。
`void`	`recordImpression()` 如果網路要求開發人員明確記錄轉譯至螢幕的檢視畫面曝光次數，則子類別應實作此方法。
`void`	`setAdChoicesContent(View adChoicesContent)` 將要用於 AdChoices 內容的檢視畫面設為 AdChoices 內容。
`final void`	`setAdvertiser(String advertiser)` 設定用來識別廣告主的文字。
`final void`	`setBody(String body)` 設定內文。
`final void`	`setCallToAction(String callToAction)` 設定廣告的行動號召 (例如「購買」或「安裝」)。
`final void`	`setExtras(Bundle extras)` 設定一組額外項目，其中包含素材資源或屬性，但不會直接對應 Google 原生廣告物件 (廣告標題、內文等) 的預期屬性。
`void`	`setHasVideoContent(boolean hasVideoContent)` 如果目前的廣告含有影片內容，請將此值設為 true。
`final void`	`setHeadline(String headline)` 設定主要文字標題。
`final void`	`setIcon(NativeAd.Image icon)` 設定可識別廣告主的圖片。
`final void`	`setImages(List<NativeAd.Image> images)` 設定大型圖片清單。
`void`	`setMediaContentAspectRatio(float mediaContentAspectRatio)` 設定要在 `MediaView` 中算繪的媒體顯示比例。
`void`	`setMediaView(View mediaView)` 設定會顯示媒體的經紀人檢視畫面。
`final void`	`setOverrideClickHandling(boolean overrideClickHandling)` 如果廣告聯播網自行處理點擊，請將此值設為 true。
`final void`	`setOverrideImpressionRecording(boolean overrideImpressionRecording)` 如果廣告聯播網自行追蹤曝光，請將此值設為 true。
`final void`	`setPrice(String price)` 針對應用程式廣告，設定代表應用程式價格的字串。
`final void`	`setStarRating(Double starRating)` 如果是應用程式廣告，則可設定星級評分 (0 到 5 顆星)，代表應用程式在提供該應用程式的商店中獲得的星級。
`final void`	`setStore(String store)` 如果是應用程式廣告，則會設定提供應用程式供下載的應用程式商店名稱。
`void`	`trackViews( View containerView, Map<String, View> clickableAssetViews, Map<String, View> nonclickableAssetViews )` 如果網路要求開發人員在將檢視區塊算繪至螢幕前，先準備記錄曝光和/或點擊的狀態，則子類別應實作此方法。
`void`	`untrackView(View view)` 如果中介聯播網的 SDK 提供停止追蹤此物件對應廣告的原生廣告檢視畫面的方法，則子類別應實作此方法。

公開欄位

adChoicesContent

public View adChoicesContent

廣告主

public String advertiser

body

public String body

行動號召

public String callToAction

其他資訊

public Bundle extras

headline

public String headline

圖示

public NativeAd.Image icon

圖片

public List<NativeAd.Image> images

mediaContentAspectRatio

public float mediaContentAspectRatio

overrideClickHandling

public boolean overrideClickHandling

overrideImpressionRecording

public boolean overrideImpressionRecording

價格

public String price

starRating

public Double starRating

儲存庫

public String store

公用建構函式

UnifiedNativeAdMapper

public UnifiedNativeAdMapper()

公用方法

getAdChoicesContent

public View getAdChoicesContent()

傳回用於 AdChoices 內容的檢視畫面。

getAdvertiser

public final String getAdvertiser()

傳回用來識別廣告主的文字。

getBody

public final String getBody()

傳回內文。

getCallToAction

public final String getCallToAction()

傳回鼓勵使用者採取行動的文字。

getCurrentTime

public float getCurrentTime()

取得影片目前的時間。預設會傳回零。子類別應覆寫此方法，以便傳回影片廣告的非零當前時間。

getDuration

public float getDuration()

取得影片的片長。預設會傳回零。子類別應覆寫此方法，以便傳回非零的影片廣告時間長度。

getExtras

public final Bundle getExtras()

傳回透過 setExtras 方法傳入的額外項目組合。

getHeadline

public final String getHeadline()

傳回主要文字標題。

getIcon

public final NativeAd.Image getIcon()

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

getImages

public final List<NativeAd.Image> getImages()

傳回大型圖片的清單。

getMediaContentAspectRatio

public float getMediaContentAspectRatio()

傳回要在 MediaView 中算繪的媒體的顯示比例。如果無法取得顯示比例，則會傳回零。

getOverrideClickHandling

public final boolean getOverrideClickHandling()

如果廣告聯播網自行處理點擊，則傳回 true。

getOverrideImpressionRecording

public final boolean getOverrideImpressionRecording()

如果廣告聯播網自行進行曝光追蹤，則傳回 true。

getPrice

public final String getPrice()

如果是應用程式廣告，則傳回字串，代表應用程式的價格。

getStarRating

public final Double getStarRating()

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

getStore

public final String getStore()

如果是應用程式廣告，則會傳回提供應用程式供下載的應用程式商店名稱。例如「Google Play」。

handleClick

public void handleClick(View view)

如果網路要求開發人員明確處理顯示在螢幕上的檢視區塊點擊事件，子類別應實作此方法。

hasVideoContent

public boolean hasVideoContent()

如果目前的廣告含有影片內容，則傳回 true。

recordImpression

public void recordImpression()

如果網路要求開發人員明確記錄轉譯至螢幕的檢視畫面曝光次數，則子類別應實作此方法。

setAdChoicesContent

public void setAdChoicesContent(View adChoicesContent)

將要用於 AdChoices 內容的檢視畫面設為 AdChoices 內容。

setAdvertiser

public final void setAdvertiser(String advertiser)

設定用來識別廣告主的文字。應用程式不必顯示此素材資源，但建議這樣做。

參數
`String advertiser`	要設定的文字

setBody

public final void setBody(String body)

設定內文。應用程式不必顯示此素材資源，但建議這樣做。

參數
`String body`	要設定的說明

setCallToAction

public final void setCallToAction(String callToAction)

設定廣告的行動號召 (例如「購買」或「安裝」)。應用程式不必顯示此素材資源，但建議這樣做。

參數
`String callToAction`	要設定的文字

setExtras

public final void setExtras(Bundle extras)

設定一組額外項目，其中包含素材資源或屬性，但不會直接對應 Google 原生廣告物件 (廣告標題、內文等) 的預期屬性。

setHasVideoContent

public void setHasVideoContent(boolean hasVideoContent)

如果目前的廣告含有影片內容，請將此值設為 true。

setHeadline

public final void setHeadline(String headline)

設定主要文字標題。應用程式必須顯示此素材資源。

setIcon

public final void setIcon(NativeAd.Image icon)

設定可識別廣告主的圖片。應用程式不必顯示此素材資源，但建議這樣做。

setImages

public final void setImages(List<NativeAd.Image> images)

設定大型圖片清單。應用程式不必顯示此素材資源，但建議這樣做。

setMediaContentAspectRatio

public void setMediaContentAspectRatio(float mediaContentAspectRatio)

設定要在 MediaView 中算繪的媒體顯示比例。

參數
`float mediaContentAspectRatio`	要設定的顯示比例

setMediaView

public void setMediaView(View mediaView)

設定會顯示媒體的經紀人檢視畫面。這通常是經過中介的 SDK 提供的 View，用於顯示廣告的影片內容，但如果沒有影片，則應顯示圖片素材資源。適配器應為每則廣告設定此屬性的 View。

setOverrideClickHandling

public final void setOverrideClickHandling(boolean overrideClickHandling)

如果廣告聯播網自行處理點擊，請將此值設為 true。

setOverrideImpressionRecording

public final void setOverrideImpressionRecording(boolean overrideImpressionRecording)

如果廣告聯播網自行追蹤曝光，請將此值設為 true。

setPrice

public final void setPrice(String price)

針對應用程式廣告，設定代表應用程式價格的字串。應用程式不必顯示此素材資源，但建議這樣做。

參數
`String price`	代表應用程式費用的字串。

setStarRating

public final void setStarRating(Double starRating)

針對應用程式廣告，您可以設定 0 到 5 顆星的星級評分，代表應用程式在提供該應用程式的商店中獲得的星級。應用程式不必顯示此素材資源，但建議這樣做。

setStore

public final void setStore(String store)

如果是應用程式廣告，則會設定提供應用程式供下載的應用程式商店名稱。例如「Google Play」。應用程式不必顯示此素材資源，但建議這樣做。

參數
`String store`	要設定的應用程式商店名稱

trackViews

public void trackViews(
    View containerView,
    Map<String, View> clickableAssetViews,
    Map<String, View> nonclickableAssetViews
)

如果網路要求開發人員在將檢視區塊算繪至螢幕前，先準備記錄曝光和/或點擊的狀態，則子類別應實作此方法。在 UnifiedNativeAdAssetNames 中找出素材資源名稱。

參數
`View containerView`	廣告的容器 `View`。
`Map<String, View> clickableAssetViews`	可點選的資產名稱的 `Map` 對應至相應的。
`Map<String, View> nonclickableAssetViews`	非可點按資產名稱的 `Map` 到對應的 `View`。

untrackView

public void untrackView(View view)

如果中介聯播網的 SDK 提供停止追蹤此物件對應廣告的原生廣告檢視畫面的方法，則子類別應實作此方法。