Interface NativeAdRequest

Extends AdRequest

A native ad request.

Properties
adChoicesPlacement?	The AdChoices placement.
adSizes?	A list of valid ad sizes for the request.
adUnitId	The ad unit ID. Inherited from the AdRequest.adUnitId property
aspectRatio?	The aspect ratio of the media to be returned.
categoryExclusions?	Slot-level ad category exclusion labels. Inherited from the AdRequest.categoryExclusions property
contentUrl?	The content URL for a website whose content matches the app's primary content. Inherited from the AdRequest.contentUrl property
customClickGestureAllowTaps?	Whether tap to click is enabled with custom click gesture.
customFormatIds?	A list of custom native ad format IDs defined in the Ad Manager UI.
customTargeting?	Custom targeting parameters. Inherited from the AdRequest.customTargeting property
extras?	Extra parameters to pass to AdMob or Ad Manager. Inherited from the AdRequest.extras property
keywords?	Keywords for targeting purposes. Inherited from the AdRequest.keywords property
manualImpressionRequested?	Whether enabling manual impression recording is requested.
mediationExtras?	Extra parameters to pass to a specific ad source adapter in a mediation setup. Inherited from the AdRequest.mediationExtras property
nativeAdTypes?	A list of native ad types for the request.
neighboringContentUrls?	URLs representing web content near an ad. Inherited from the AdRequest.neighboringContentUrls property
placementId?	A long integer provided by the AdMob UI for the configured placement. Inherited from the AdRequest.placementId property
publisherProvidedId?	An identifier for use in frequency capping, audience segmentation and targeting, sequential ad rotation, and other audience-based ad delivery controls across devices. Inherited from the AdRequest.publisherProvidedId property
skipUninitializedAdapters?	Instructs the SDK to not collect bidding signals or execute waterfall elements for adapters that haven't yet successfully initialized. Inherited from the AdRequest.skipUninitializedAdapters property
videoOptions?	The VideoOptions for the request.

Properties

---

Optional Readonly adChoicesPlacement

adChoicesPlacement?: AdChoicesPlacement

The AdChoices placement.

---

Optional Readonly adSizes

adSizes?: readonly AdSize[]

A list of valid ad sizes for the request.

This feature is available to Ad Manager publishers only.

---

Readonly adUnitId

adUnitId: string

The ad unit ID.

---

Optional Readonly aspectRatio

aspectRatio?: NativeMediaAspectRatio

The aspect ratio of the media to be returned.

---

Optional Readonly categoryExclusions

categoryExclusions?: readonly string[]

Slot-level ad category exclusion labels.

This feature is applicable only to Ad Manager ad requests. Category exclusions are ignored on AdMob requests.

---

Optional Readonly contentUrl

contentUrl?: string

The content URL for a website whose content matches the app's primary content. This website content is used for targeting and brand safety purposes.

---

Optional Readonly customClickGestureAllowTaps

customClickGestureAllowTaps?: boolean

Whether tap to click is enabled with custom click gesture.

Available for allowlisted publishers only. These settings are ignored for publishers who aren't allowlisted.

---

Optional Readonly customFormatIds

customFormatIds?: readonly string[]

A list of custom native ad format IDs defined in the Ad Manager UI.

Used to load native ads of type NativeAdType.CUSTOM_NATIVE.

See also

• Create custom native ad formats

---

Optional Readonly customTargeting

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

Custom targeting parameters.

This feature is applicable only to Ad Manager ad requests. Custom targeting is ignored on AdMob requests.

---

Optional Readonly extras

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

Extra parameters to pass to AdMob or Ad Manager.

Values must be JSON-serializable types (strings, numbers, booleans, null, or arrays or objects of these types). Functions, class instances, or complex JavaScript types such as Set and Map aren't supported.

---

Optional Readonly keywords

keywords?: readonly string[]

Keywords for targeting purposes.

---

Optional Readonly manualImpressionRequested

manualImpressionRequested?: boolean

Whether enabling manual impression recording is requested.

---

Optional Readonly mediationExtras

mediationExtras?: readonly MediationExtras[]

Extra parameters to pass to a specific ad source adapter in a mediation setup.

---

Optional Readonly nativeAdTypes

nativeAdTypes?: readonly NativeAdType[]

A list of native ad types for the request.

---

Optional Readonly neighboringContentUrls

neighboringContentUrls?: readonly string[]

URLs representing web content near an ad. Promotes brand safety and allows displayed ads to have an app-level rating, such as MA, T, or PG, that's more appropriate to neighboring content.

---

Optional Readonly placementId

placementId?: bigint

A long integer provided by the AdMob UI for the configured placement.

---

Optional Readonly publisherProvidedId

publisherProvidedId?: string

An identifier for use in frequency capping, audience segmentation and targeting, sequential ad rotation, and other audience-based ad delivery controls across devices.

This feature is applicable only to Ad Manager ad requests. Any ID is ignored on AdMob requests.

---

Optional Readonly skipUninitializedAdapters

skipUninitializedAdapters?: boolean

Instructs the SDK to not collect bidding signals or execute waterfall elements for adapters that haven't yet successfully initialized.

---

Optional Readonly videoOptions

videoOptions?: VideoOptions

The VideoOptions for the request.