此页面由 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()`

公共方法
`View`	`getAdChoicesContent()` 返回用作 AdChoices 内容的视图。
`final String`	`getAdvertiser()` 返回用于标识广告客户的文字。
`final String`	`getBody()` 返回正文。
`final String`	`getCallToAction()` 返回鼓励用户通过广告采取某些行动的文字。
`float`	`getCurrentTime()` 获取视频的当前时间。
`float`	`getDuration()` 获取视频的时长。
`final Bundle`	`getExtras()` 返回通过 setExtras 方法传入的 extras 软件包。
`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)` 设置一个包含素材资源或属性的 extra 软件包，这些素材资源或属性不直接映射到 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

callToAction

public String callToAction

extras

public Bundle extras

标题

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()

公共方法

getAdChoicesContent

public View getAdChoicesContent()

返回用作 AdChoices 内容的视图。

getAdvertiser

public final String getAdvertiser()

返回用于标识广告客户的文字。

getBody

public final String getBody()

返回正文。

getCallToAction

public final String getCallToAction()

返回鼓励用户通过广告采取某些行动的文字。

getCurrentTime

public float getCurrentTime()

获取视频的当前时间。默认返回 0。子类应覆盖此方法，以便为视频广告返回非零的当前时间。

getDuration

public float getDuration()

获取视频的时长。默认返回 0。子类应覆盖此方法，以便为视频广告返回非零时长。

getExtras

public final Bundle getExtras()

返回通过 setExtras 方法传入的 extras 软件包。

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)

设置一个包含素材资源或属性的 extra 软件包，这些素材资源或属性不直接映射到 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 提供了一种停止跟踪此对象映射的广告的原生广告视图的方法，子类应实现此方法。