BannerAdRequest 接口

扩展 AdRequest

横幅广告请求。

您必须提供 adSize或adSizes中的一个，且只能提供一个。

属性
adSize?	要请求的广告尺寸。
adSizes?	请求的有效广告尺寸列表。
adUnitId	广告单元 ID。 沿用自 AdRequest.adUnitId 属性
categoryExclusions?	广告位级广告类别排除标签。 沿用自 AdRequest.categoryExclusions 属性
contentUrl?	网站的内容与应用的主要内容相符的内容网址。 沿用自 AdRequest.contentUrl 属性
customTargeting?	自定义定位参数。 沿用自 AdRequest.customTargeting 属性
extras?	要传递给 AdMob 或 Ad Manager 的额外参数。 沿用自 AdRequest.extras 属性
keywords?	用于定位的关键字。 沿用自 AdRequest.keywords 属性
manualImpressionRequested?	是否请求启用手动展示次数记录。
mediationExtras?	要传递给中介设置中特定广告来源适配器的额外参数。 中介设置。 沿用自 AdRequest.mediationExtras 属性
neighboringContentUrls?	表示广告附近网页内容的网址。 沿用自 AdRequest.neighboringContentUrls 属性
placementId?	AdMob 界面为配置的 展示位置提供的长整数。 沿用自 AdRequest.placementId 属性
publisherProvidedId?	用于实现跨设备的频次上限、受众群 细分和定位、广告依序轮播，以及其他 基于受众群体的广告投放控制的标识符。 沿用自 AdRequest.publisherProvidedId 属性
skipUninitializedAdapters?	指示 SDK 不要为尚未成功初始化的适配器收集出价信号或执行 瀑布流元素。 沿用自 AdRequest.skipUninitializedAdapters 属性
videoOptions?	请求的 VideoOptions 。

属性

---

Optional Readonly adSize

adSize?: AdSize | Promise<AdSize>

要请求的广告尺寸。

---

Optional Readonly adSizes

adSizes?: readonly (AdSize | Promise<AdSize>)[]

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

此功能仅供 Ad Manager 发布商使用。AdMob 发布商应改用 adSize 。

---

Readonly adUnitId

adUnitId: string

广告单元 ID。

---

Optional Readonly categoryExclusions

categoryExclusions?: readonly string[]

广告位级广告类别排除标签。

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

---

Optional Readonly contentUrl

contentUrl?: string

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

---

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

keywords?: readonly string[]

用于定位的关键字。

---

Optional Readonly manualImpressionRequested

manualImpressionRequested?: boolean

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

---

Optional Readonly mediationExtras

mediationExtras?: readonly MediationExtras[]

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

---

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 。