SwipeableInterstitialAdRequest.Builder

@ExperimentalApi
public final class SwipeableInterstitialAdRequest.Builder implements SwipeableInterstitialRequest.Builder


A builder for a swipeable interstitial ad request.

Summary

Public constructors

Builder(@NonNull String adUnitId)

Public methods

final @NonNull SwipeableInterstitialAdRequest.Builder

Sets a slot-level ad category exclusion label.

final @NonNull SwipeableInterstitialAdRequest.Builder

Adds a keyword for targeting purposes.

final @NonNull SwipeableInterstitialAdRequest

Constructs an SwipeableInterstitialAdRequest with the specified attributes.

@NonNull SwipeableInterstitialAdRequest.Builder
@CanIgnoreReturnValue
enableCustomClickSwipeGesture(
    @NonNull NativeAd.SwipeGestureDirection customClickSwipeGestureDirection,
    boolean customClickSwipeGestureTapsAllowed
)

Enables swipes as a custom click gesture.

final @NonNull SwipeableInterstitialAdRequest.Builder

Adds extra parameters to pass to a specific ad source adapter.

final @NonNull SwipeableInterstitialAdRequest.Builder

Adds a custom targeting parameter.

final @NonNull SwipeableInterstitialAdRequest.Builder

Adds a custom targeting parameter with multiple values.

@NonNull SwipeableInterstitialAdRequest.Builder
@CanIgnoreReturnValue
setAdSize(int width, int height)

Sets the size of the ad.

final @NonNull SwipeableInterstitialAdRequest.Builder

Sets the content URL for a web site whose content matches the app's primary content.

final @NonNull SwipeableInterstitialAdRequest.Builder

Set extra parameters to pass to AdMob or Ad Manager.

@NonNull SwipeableInterstitialAdRequest.Builder
@CanIgnoreReturnValue
setMaxScreenHoldDurationSeconds(int maxScreenHoldDurationSeconds)

Specifies the maximum duration (in seconds) the app commits to holding the ad on screen before it is eligible for dismissal.

final @NonNull SwipeableInterstitialAdRequest.Builder

Sets URLs representing web content near an ad.

@NonNull SwipeableInterstitialAdRequest.Builder

Sets a default placement ID for the loaded ad.

final @NonNull SwipeableInterstitialAdRequest.Builder

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

final @NonNull SwipeableInterstitialAdRequest.Builder

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

final @NonNull SwipeableInterstitialAdRequest.Builder

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

Public constructors

Builder

public Builder(@NonNull String adUnitId)

Public methods

addCategoryExclusion

@CanIgnoreReturnValue
public final @NonNull SwipeableInterstitialAdRequest.Builder addCategoryExclusion(@NonNull String categoryExclusion)

Sets a slot-level ad category exclusion label.

This feature is only applicable for Ad Manager ad requests. Any category exclusions will be ignored on AdMob requests.

addKeyword

@CanIgnoreReturnValue
public final @NonNull SwipeableInterstitialAdRequest.Builder addKeyword(@NonNull String keyword)

Adds a keyword for targeting purposes.

build

public final @NonNull SwipeableInterstitialAdRequest build()

Constructs an SwipeableInterstitialAdRequest with the specified attributes.

enableCustomClickSwipeGesture

@CanIgnoreReturnValue
public @NonNull SwipeableInterstitialAdRequest.Builder enableCustomClickSwipeGesture(
    @NonNull NativeAd.SwipeGestureDirection customClickSwipeGestureDirection,
    boolean customClickSwipeGestureTapsAllowed
)

Enables swipes as a custom click gesture.

Available for allowlisted publishers only. These settings will be ignored for publishers not allowlisted.

Parameters
@NonNull NativeAd.SwipeGestureDirection customClickSwipeGestureDirection

The SwipeGestureDirection to be counted as a click.

boolean customClickSwipeGestureTapsAllowed

Whether taps should still be allowed as clicks. Default is true.

putAdSourceExtrasBundle

@CanIgnoreReturnValue
public final @NonNull SwipeableInterstitialAdRequest.Builder putAdSourceExtrasBundle(
    @NonNull Class<@NonNull MediationExtrasReceiver> adapterClass,
    @NonNull Bundle adSourceExtras
)

Adds extra parameters to pass to a specific ad source adapter.

Parameters
@NonNull Class<@NonNull MediationExtrasReceiver> adapterClass

The Class of the adapter that should receive extras.

@NonNull Bundle adSourceExtras

A Bundle of extra information to pass to a mediation adapter.

putCustomTargeting

@CanIgnoreReturnValue
public final @NonNull SwipeableInterstitialAdRequest.Builder putCustomTargeting(@NonNull String key, @NonNull String value)

Adds a custom targeting parameter. Calling this a second time with the same key will overwrite the old values.

This feature is only applicable for Ad Manager ad requests. Any custom targeting will be ignored on AdMob requests.

putCustomTargeting

@CanIgnoreReturnValue
public final @NonNull SwipeableInterstitialAdRequest.Builder putCustomTargeting(
    @NonNull String key,
    @NonNull List<@NonNull String> values
)

Adds a custom targeting parameter with multiple values. Calling this a second time with the same key will overwrite the old values.

This feature is only applicable for Ad Manager ad requests. AdMob requests currently ignore custom targeting.

setAdSize

@CanIgnoreReturnValue
public @NonNull SwipeableInterstitialAdRequest.Builder setAdSize(int width, int height)

Sets the size of the ad.

If this method is not called, the ad defaults to full-screen size dimensions.

Note: The ad size must be at least 60% of the screen size. Sizes smaller than this threshold will result in a load failure.

Parameters
int width

The width of the requested ad in dp.

int height

The height of the requested ad in dp.

setContentUrl

@CanIgnoreReturnValue
public final @NonNull SwipeableInterstitialAdRequest.Builder setContentUrl(@NonNull String contentUrl)

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

Throws
kotlin.IllegalArgumentException

If contentUrl is empty.

setGoogleExtrasBundle

@CanIgnoreReturnValue
public final @NonNull SwipeableInterstitialAdRequest.Builder setGoogleExtrasBundle(@NonNull Bundle extraBundle)

Set extra parameters to pass to AdMob or Ad Manager. Calling this a second time will overwrite the old values.

Parameters
@NonNull Bundle extraBundle

A Bundle of extra information to pass to AdMob or Ad Manager.

setMaxScreenHoldDurationSeconds

@CanIgnoreReturnValue
public @NonNull SwipeableInterstitialAdRequest.Builder setMaxScreenHoldDurationSeconds(int maxScreenHoldDurationSeconds)

Specifies the maximum duration (in seconds) the app commits to holding the ad on screen before it is eligible for dismissal. The SDK only returns ads with a hold requirement that is less than or equal to this value. Defaults to 0.

Only set this property if your app implements logic to hold swipeable interstitial ads on screen.

Parameters
int maxScreenHoldDurationSeconds

The maximum screen hold duration in seconds. Must be positive.

setNeighboringContentUrls

@CanIgnoreReturnValue
public final @NonNull SwipeableInterstitialAdRequest.Builder setNeighboringContentUrls(
    @NonNull Set<@NonNull String> neighboringContentUrls
)

Sets URLs representing web content near an ad. Promotes brand safety and allows displayed ads to have an app level rating (MA, T, PG, etc) that is more appropriate to neighboring content.

Parameters
@NonNull Set<@NonNull String> neighboringContentUrls

The set of neighboring content URLs to be attached to the existing neighboring content URLs.

setPlacementId

@CanIgnoreReturnValue
public @NonNull SwipeableInterstitialAdRequest.Builder setPlacementId(long placementId)

Sets a default placement ID for the loaded ad.

Parameters
long placementId

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

setPublisherProvidedId

@CanIgnoreReturnValue
public final @NonNull SwipeableInterstitialAdRequest.Builder setPublisherProvidedId(@NonNull String publisherProvidedId)

Sets 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 only applicable for Ad Manager ad requests. Any ID will be ignored on AdMob requests.

setRequestAgent

@CanIgnoreReturnValue
public final @NonNull SwipeableInterstitialAdRequest.Builder setRequestAgent(@NonNull String requestAgent)

Sets the request agent string to identify the ad request's origin. Third party libraries that implement the Mobile Ads SDK on behalf of publishers should call this method to denote the platform from which the ad request originated.

skipUninitializedAdapters

@ExperimentalApi
public final @NonNull SwipeableInterstitialAdRequest.Builder skipUninitializedAdapters()

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

Protected methods

getAdSourceExtrasBundles

protected final @NonNull Map<@NonNull String, @NonNull BundlegetAdSourceExtrasBundles()

getAdUnitId

protected final String getAdUnitId()

The ad unit ID.

getCategoryExclusions

protected final @NonNull Set<@NonNull StringgetCategoryExclusions()

getContentUrl

protected final String getContentUrl()

getCustomTargeting

protected final @NonNull Map<@NonNull String, @NonNull StringgetCustomTargeting()

getGoogleExtrasBundle

protected final @NonNull Bundle getGoogleExtrasBundle()

getKeywords

protected final @NonNull HashSet<@NonNull StringgetKeywords()

getNeighboringContentUrls

protected final @NonNull HashSet<@NonNull StringgetNeighboringContentUrls()

getPlacementId

protected final long getPlacementId()

getPublisherProvidedId

protected final String getPublisherProvidedId()

getRequestAgent

protected final String getRequestAgent()

getSkipUninitializedAdapters

protected final boolean getSkipUninitializedAdapters()

setAdUnitId

protected final void setAdUnitId(String adUnitId)

The ad unit ID.