歡迎加入 Google 廣告與評估社群的官方 AdMob Discord 頻道，一起討論產品並交流心得。

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

NativeAdMapper

Kotlin |Java

public abstract class NativeAdMapper

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

載入原生廣告的中介服務轉接程式必須擴充這個類別，才能提供中介廣告聯播網原生廣告物件到 com.google.android.gms.ads.nativead.NativeAd 的對應。

摘要

公開欄位
`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`

公用建構函式
`NativeAdMapper()`

公用方法
`void`	`destroy()` 如果中介服務聯播網的 SDK 提供方法來終結原生廣告物件，子類別應實作這個方法。
`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 內容的檢視區塊。
`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

公用建構函式

NativeAdMapper

public NativeAdMapper()

公用方法

destroy

public void destroy()

如果中介服務聯播網的 SDK 提供方法來終結原生廣告物件，子類別應實作這個方法。

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 內容的檢視區塊。

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
)

如果網路要求開發人員在檢視畫面顯示到螢幕前，準備記錄曝光和/或點擊的狀態，子類別就應實作這個方法。在 NativeAdAssetNames 中找出資產名稱。

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

untrackView

public void untrackView(View view)

如果中介服務聯播網的 SDK 提供停止追蹤這個物件對應廣告的原生廣告檢視區塊的方法，子類別應實作這個方法。