介面 NativeAdRequest

延長 AdRequest

原生廣告請求。

屬性
adChoicesPlacement?	AdChoices 刊登位置。
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 UI 針對已設定的刊登位置顯示的長整數。 沿用自「AdRequest.placementId」資源
publisherProvidedId?	用於展示頻率上限、目標對象區隔和指定目標、廣告依序輪播，以及其他以目標對象為準的跨裝置廣告放送控制項。 沿用自「AdRequest.publisherProvidedId」資源
skipUninitializedAdapters?	指示 SDK 不要收集出價信號，或執行尚未成功初始化的轉接程式刊登序列元素。 沿用自「AdRequest.skipUninitializedAdapters」資源
videoOptions?	要求的 VideoOptions。

屬性

---

Optional Readonly adChoicesPlacement

adChoicesPlacement?: AdChoicesPlacement

AdChoices 刊登位置。

---

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

---

Optional Readonly publisherProvidedId

publisherProvidedId?: string

這個 ID 可用於設定展示頻率上限、目標對象區隔和指定目標、廣告依序輪播，以及其他依目標對象調整的跨裝置廣告放送控制項。

這項功能僅適用於 Ad Manager 廣告請求。AdMob 請求會忽略任何 ID。

---

Optional Readonly skipUninitializedAdapters

skipUninitializedAdapters?: boolean

指示 SDK 不要收集出價信號，也不要為尚未成功初始化的轉接程式執行刊登序列元素。

---

Optional Readonly videoOptions

videoOptions?: VideoOptions

要求的 VideoOptions。