NativeAdRequest

fun getAdSourceExtrasBundle(adapterClass: Class<MediationExtrasReceiver>): Bundle?

Gets the extras bundle associated with an ad source's adapter, if present.

open val adChoicesPlacement: AdChoicesPlacement

The AdChoices placement.

@ExperimentalApi
val adPersistenceEnabled: Boolean

Determines whether ad persistence is enabled for this request.

When enabled, this field introduces two distinct behavior changes to the ad loading process:

1. Cache-First Retrieval: The SDK attempts to serve an ad from local storage first. If the cache is empty, it falls back to a network request.

2. Proactive Refresh: Regardless of how the current ad was served, the SDK fetches additional ads and persists them to local storage to service the next request.

val categoryExclusions: Set<String>

The slot-level ad category exclusion labels. Default to an empty Set if not set.

val contentUrl: String?

The content URL targeting information. Default to null if not set.

open val customClickGestureAllowTaps: Boolean

Whether tap to click is enabled with custom click gesture.

open val customClickGestureDirection: NativeAd.SwipeGestureDirection?

The requested custom click gesture direction.

open val customFormatIds: List<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.

val customTargeting: Map<String, String>

The custom targeting parameters. Default to an empty Map if not set.

val googleExtrasBundle: Bundle

The extra parameters to pass to Google ad network

open val isImageLoadingDisabled: Boolean

Whether image downloading is disabled.

val keywords: Set<String>

The targeting information keywords.

open val mediaAspectRatio: NativeAd.NativeMediaAspectRatio

The aspect ratio of the media to be returned.

open val nativeAdTypes: List<NativeAd.NativeAdType>

A list of native ad types for the request.

val neighboringContentUrls: Set<String>

The list of neighboring content URLs or an empty List if no URLs were set.

val placementId: Long

An identifier for a placement in reporting. A value set here will be set onto any ad returned by this request.

val publisherProvidedId: String?

A publisher-provided identifier used for frequency capping, audience segmentation and targeting, sequential ad rotation, and other audience-based ad delivery controls across devices.

val requestAgent: String?

The request agent string to identify the ad request's origin.

open val videoOptions: VideoOptions?

The VideoOptions for the request.