Test creative types

  • 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 

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

val request = AdRequest
  .Builder()
  .addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
  .build()

Java 

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

AdRequest request = new AdRequest
  .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.