介面 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 UI 針對已設定的刊登位置顯示的長整數。 沿用自「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 序列化的型別 (字串、數字、布林值、空值，或是這些型別的陣列或物件)。系統不支援函式、類別例項或複雜的 JavaScript 型別，例如 Set 和 Map。

---

Optional Readonly 關鍵字

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。