Test creative types

  • The Google Mobile Ads C++ SDK is deprecated as of June 17, 2024 and should not be adopted in new projects.

  • Instead of the Google Mobile Ads C++ SDK, consider using the iOS and Android SDKs from AdMob.

  • The Google Mobile Ads SDK provides an API to specify a creative type for test queries using theft_ctype parameter.

  • Theft_ctype parameter only works in Test Mode and impacts only Google ads, not ads from third-party sources through mediation.

  • Theft_ctype parameter can be added to anAdRequest using theadd_extra method with a specifiedadapter_class_name,extra_key of "ft_ctype", and a validextra_value from the provided table.

DEPRECATED: The Google Mobile Ads C++ SDK isdeprecated as of June 17, 2024 and should not be adopted in projects that don't already use it. It will enterEnd-of-Maintenance (EoM) on June 17, 2025. Note that versions of the SDK released before the EoM date will continue to function, but no further bug fixes or changes will be released after the EoM date.

Instead of the Google Mobile Ads C++ SDK, consider using theiOS andAndroid SDKs from AdMob. For support, reach out to thecontact us form.


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

Usage

To specify a creative type, include theft_ctype parameter in an extras objectand pass it to the ad request. This may restrict which ads are available andresult in no fill.

Note: Theft_ctype parameter only works inTest Mode.

Android

AdRequestad_request;ad_request.add_extra(/*adapter_class_name=*/"com.google.ads.mediation.admob.AdMobAdapter",/*extra_key=*/"ft_ctype",/*extra_value=*/"video_app_install");

iOS

AdRequestad_request;ad_request.add_extra(/*adapter_class_name=*/"GADExtras",/*extra_key=*/"ft_ctype",/*extra_value=*/"video_app_install");

The following table lists the valid values forft_ctype:

Creative Typeft_ctypeFormat
HTML5html5Banner, Interstitial, Rewarded
App install imageimage_app_installBanner, Native, Interstitial, Rewarded
Display imageimage_displayBanner, Interstitial
Display partial slotpartial_slotBanner, Native, Interstitial
App install texttext_app_installBanner, Native, Interstitial
Display texttext_displayBanner, Native, Interstitial
TrueviewtrueviewInterstitial, Rewarded
App install videovideo_app_installBanner, Native, Interstitial, Rewarded

This feature impacts Google ads only. If your ad unit enablesmediation, ads returned from third-party ad sources don'trespect theft_ctype parameter. We recommend testing with an ad unit thatdoesn't have mediation enabled.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.