NativeAdRequest 接口

扩展 AdRequest

原生广告请求。

属性
adChoicesPlacement?	“广告选项”图标位置。
adSizes?	相应请求的有效广告尺寸列表。
adUnitId	广告单元 ID。 继承自 AdRequest.adUnitId 属性
aspectRatio?	要返回的媒体的宽高比。
categoryExclusions?	广告位级广告类别排除标签。 继承自 AdRequest.categoryExclusions 属性
contentUrl?	内容与应用的主要内容相符的网站的内容网址。 继承自 AdRequest.contentUrl 属性
customClickGestureAllowTaps?	是否启用点按即点按功能以及自定义点击手势。
customFormatIds?	Ad Manager 界面中定义的一系列自定义原生广告格式 ID。
customTargeting?	自定义定位参数。 继承自 AdRequest.customTargeting 属性
extras?	要传递给 AdMob 或 Ad Manager 的额外参数。 继承自 AdRequest.extras 属性
keywords?	用于定位的关键字。 继承自 AdRequest.keywords 属性
manualImpressionRequested?	是否请求启用手动记录展示次数。
mediationExtras?	在进行中介设置时，要传递给特定广告来源适配器的额外参数。 继承自 AdRequest.mediationExtras 属性
nativeAdTypes?	相应请求的原生广告类型列表。
neighboringContentUrls?	表示广告附近网页内容的网址。 继承自 AdRequest.neighboringContentUrls 属性
placementId?	AdMob 界面针对已配置的展示位置提供的长整数。 继承自 AdRequest.placementId 属性
publisherProvidedId?	一种标识符，用于跨设备实现频次上限、受众群细分和定位、依序广告轮播以及基于受众群体的其他广告投放控制功能。 继承自 AdRequest.publisherProvidedId 属性
skipUninitializedAdapters?	指示 SDK 不为尚未成功初始化的适配器收集出价信号或执行瀑布流元素。 继承自 AdRequest.skipUninitializedAdapters 属性
videoOptions?	相应请求的 VideoOptions。

属性

---

Optional Readonly adChoicesPlacement

adChoicesPlacement?: AdChoicesPlacement

“广告选项”图标位置。

---

Optional Readonly adSizes

adSizes?: readonly AdSize[]

相应请求的有效广告尺寸列表。

此功能仅适用于 Ad Manager 发布商。

---

Readonly adUnitId

adUnitId: string

广告单元 ID。

---

Optional Readonly aspectRatio

aspectRatio?: NativeMediaAspectRatio

要返回的媒体的宽高比。

---

Optional Readonly categoryExclusions

categoryExclusions?: readonly string[]

展示位置级广告类别排除标签。

此功能仅适用于 Ad Manager 广告请求。在 AdMob 请求中，系统会忽略类别排除对象。

---

Optional Readonly contentUrl

contentUrl?: string

内容与应用的主要内容相符的网站的内容网址。此网站内容用于定位和品牌保障目的。

---

Optional Readonly customClickGestureAllowTaps

customClickGestureAllowTaps?: boolean

点按即点是否已通过自定义点击手势启用。

仅适用于列入许可名单的发布商。对于未列入许可名单的发布商，系统会忽略这些设置。

---

Optional Readonly customFormatIds

customFormatIds?: readonly string[]

在 Ad Manager 界面中定义的自定义原生广告格式 ID 的列表。

用于加载类型为 NativeAdType.CUSTOM_NATIVE 的原生广告。

另请参阅

• 创建自定义原生广告格式

---

Optional Readonly customTargeting

customTargeting?: Readonly<Record<string, string | readonly string[]>>

自定义定位参数。

此功能仅适用于 Ad Manager 广告请求。系统会忽略 AdMob 请求中的自定义定位条件。

---

Optional Readonly extras

extras?: Readonly<Record<string, unknown>>

要传递给 AdMob 或 Ad Manager 的额外参数。

值必须是可进行 JSON 序列化的类型（字符串、数字、布尔值、null 或这些类型的数组或对象）。不支持函数、类实例或复杂的 JavaScript 类型（例如 Set 和 Map）。

---

Optional Readonly 关键字

keywords?: readonly string[]

用于定位的关键字。

---

Optional Readonly manualImpressionRequested

manualImpressionRequested?: boolean

是否请求启用手动记录展示次数。

---

Optional Readonly mediationExtras

mediationExtras?: readonly MediationExtras[]

在进行中介设置时，要传递给特定广告来源适配器的额外参数。

---

Optional Readonly nativeAdTypes

nativeAdTypes?: readonly NativeAdType[]

相应请求的原生广告类型列表。

---

Optional Readonly neighboringContentUrls

neighboringContentUrls?: readonly string[]

表示广告附近网页内容的网址。可保障广告不会投放到不利于品牌形象的内容中，并允许所展示的广告具有应用级分级（例如 MA、T 或 PG），以便更适合相邻的内容。

---

Optional Readonly placementId

placementId?: bigint

AdMob 界面针对已配置的展示位置提供的长整数。

---

Optional Readonly publisherProvidedId

publisherProvidedId?: string

一种标识符，可用于跨设备实现频次上限、受众群细分和定位、依序广告轮播以及基于受众群体的其他广告投放控制功能。

此功能仅适用于 Ad Manager 广告请求。在 AdMob 请求中，系统会忽略所有 ID。

---

Optional Readonly skipUninitializedAdapters

skipUninitializedAdapters?: boolean

指示 SDK 不为尚未成功初始化的适配器收集出价信号或执行瀑布流元素。

---

Optional Readonly videoOptions

videoOptions?: VideoOptions

相应请求的 VideoOptions。