Test creative types

  • Google Mobile Ads SDK allows you to specify a desired creative type for test queries using the ft_ctype request parameter.

  • This parameter helps to retrieve and render only specific creative types like video, image, or HTML5 during testing.

  • This feature is only functional in Test Mode and impacts Google ads, not ads from third-party networks through mediation.

  • Using the ft_ctype parameter can potentially increase the chances of encountering no fills due to ad restrictions.

  • Several creative types including video_app_install, html5, and image_app_install can be specified using the ft_ctype parameter.
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.

Swift 

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

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

Objective-C 

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

GADRequest *request = [GADRequest 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.