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.

• This feature only applies to Google ads in Test Mode and doesn't affect reservation inventory or mediated ads.

• The ft_ctype parameter is included in an extras object passed to the ad request.

• Valid values for ft_ctype correspond to different creative types and formats.

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.

Important: This feature doesn't apply to reservation inventory, which may still serve if not explicitly disabled for the specified slot. We recommend that you test with a backfill-only ad unit.

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.

Note: The ft_ctype parameter only works in Test Mode.

Swift

let extras = Extras()
extras.additionalParameters = ["ft_ctype": "video_app_install"]

let request = AdManagerRequest()
request.register(extras)

Objective-C

GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"ft_ctype" : @"video_app_install"};

GAMRequest *request = [GAMRequest request];
[request registerAdNetworkExtras:extras];

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.