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

返回“广告选项”标示的信息。
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 @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 移动广告 SDK 现在使用 enableCustomClickGestureDirection 中请求的点击手势方向来跟踪自定义点击手势。
abstract boolean
recordImpression(Bundle impressionData)

应在广告首次展示时调用。
abstract void
reportTouchEvent(Bundle touchEventData)

应在广告上发生触摸事件时调用。
abstract void

为广告设置 MuteThisAdListener。
abstract void

注册一个回调，以便在系统估算此广告赚取了收入时调用该回调。
abstract void

为广告设置 UnconfirmedClickListener。

公共构造函数

NativeAd

public NativeAd()

公共方法

cancelUnconfirmedClick

public abstract void cancelUnconfirmedClick()

取消之前为广告记录的未经确认的点击。

销毁

public abstract void destroy()

销毁广告对象。调用 destroy 后，不应对广告对象调用任何其他方法。

enableCustomClickGesture

public abstract void enableCustomClickGesture()

允许发布商针对此 NativeAd 使用自定义手势报告点击次数。广告单元必须已列入许可名单，才能使用此方法。

默认情况下，SDK 会跟踪素材资源视图的点击。如果调用了此方法，SDK 将不再跟踪此 NativeAd 的点击次数。应在展示广告之前调用此方法。

getAdChoicesInfo

public abstract @Nullable NativeAd.AdChoicesInfo getAdChoicesInfo()

返回“广告选项”标示的信息。

getAdvertiser

public abstract @Nullable String getAdvertiser()

返回用于标识广告客户的文字。应用无需显示此资源，但建议这样做。

getBody

public abstract @Nullable String getBody()

返回正文。应用必须显示此资源。

getCallToAction

public abstract @Nullable String getCallToAction()

返回广告的号召性用语（例如“购买”或“安装”）。应用无需显示此资源，但建议这样做。

getExtras

public abstract Bundle getExtras()

返回与原生广告关联的一组额外素材资源。如果中介合作伙伴的广告除了标准素材资源（价格、商店等）之外还有其他素材资源，则可以通过调用 setExtras 中的相应方法来设置这些素材资源，并可以通过此方法检索这些素材资源。对于非中介流程，它会返回一个空 bundle。

getHeadline

public abstract @Nullable String getHeadline()

返回主要文本标题。应用必须显示此资源。

getIcon

public abstract @Nullable NativeAd.Image getIcon()

返回用于标识广告客户的小图片。应用无需显示此资源，但建议这样做。

getImages

public abstract List<NativeAd.Image> getImages()

返回大图列表。应用无需显示此资源，但建议这样做。

getMediaContent

public abstract @Nullable MediaContent getMediaContent()

返回与此广告关联的 MediaContent。

getMuteThisAdReasons

public abstract List<MuteThisAdReason> getMuteThisAdReasons()

返回可用于此广告的“不再显示该广告”原因。使用类中的文本说明向用户显示。

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

如果成功记录了展示，则为 true

reportTouchEvent

public abstract void reportTouchEvent(Bundle touchEventData)

应在广告上发生触摸事件时调用。广告单元必须已列入许可名单，才能使用此 API。如果您有兴趣使用此功能，请与您的客户经理联系。

参数
Bundle touchEventData

包含触摸事件坐标和时长的软件包。

touchEventData Bundle 的 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)

注册一个回调，以便在系统估算此广告赚取了收入时调用该回调。

setUnconfirmedClickListener

public abstract void setUnconfirmedClickListener(
    NativeAd.UnconfirmedClickListener listener
)

为广告设置 UnconfirmedClickListener。