Test creative types

AI-generated Key Takeaways

The Google Mobile Ads SDK allows specifying a creative type for test queries using the ft_ctype parameter.
Including the ft_ctype parameter in an extras object and passing it to the ad request restricts the types of ads retrieved and rendered.
The ft_ctype parameter is only functional when Test Mode is enabled.
Valid values for ft_ctype and their corresponding formats are listed in a table.
This feature only affects Google ads and is not respected by third-party ad sources when mediation is enabled.

Google Mobile Ads SDK (beta) 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

val extras = Bundle()
extras.putString("ft_ctype", "video_app_install")

val request = AdRequest
  .Builder(AD_UNIT_ID)
  .setGoogleExtrasBundle(extras)
  .build()

Java

Bundle extras = new Bundle();
extras.putString("ft_ctype", "video_app_install");

AdRequest request = new AdRequest
  .Builder(AD_UNIT_ID)
  .setGoogleExtrasBundle(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.