To discuss and provide feedback on our products, join the official AdMob Discord channel in the Google Advertising and Measurement Community server.

Test creative types

Spark icon

AI-generated Key Takeaways

The Google Mobile Ads SDK allows you to specify a desired creative type for test queries, ensuring only creatives of that type are retrieved and rendered.
To use this feature, set the ft_ctype request parameter within a bundle of extras in test mode, specifying the desired creative type like "video_app_install" or "html5".
This feature works with various creative types, formats, and ad units, as detailed in the provided table mapping creative types to their corresponding ft_ctype values.
While useful for testing, using ft_ctype may increase the chance of no fills and only affects Google ads, not those from third-party ad networks through mediation.

Select platform: Android iOS

Google Mobile Ads SDK provides an API that lets you specify a creative type for test queries. When the parameter is set, only creatives of the specified type are retrieved and rendered.

Usage

To specify a creative type, include the ft_ctype parameter in an extras object and pass it to the ad request. This may restrict which ads are available and result in no fill.

Kotlin

valextras=Bundle()
extras.putString("ft_ctype","video_app_install")
valrequest=AdRequest
.Builder()
.addNetworkExtrasBundle(AdMobAdapter::class.java,extras)
.build()

Java

Bundleextras=newBundle();
extras.putString("ft_ctype","video_app_install");
AdRequestrequest=newAdRequest
.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class,extras)
.build();

The following table lists the valid values for ft_ctype:

Creative Type	ft_ctype	Format
HTML5	html5	Banner, Interstitial, Rewarded
App install image	image_app_install	Banner, Native, Interstitial, Rewarded
Display image	image_display	Banner, Interstitial
Display partial slot	partial_slot	Banner, Native, Interstitial
App install text	text_app_install	Banner, Native, Interstitial
Display text	text_display	Banner, Native, Interstitial
Trueview	trueview	Interstitial, Rewarded
App install video	video_app_install	Banner, Native, Interstitial, Rewarded

This feature impacts Google ads only. If your ad unit enables mediation, ads returned from third-party ad sources don't respect the ft_ctype parameter. We recommend testing with an ad unit that doesn't have mediation enabled.