Stay organized with collections
Save and categorize content based on your preferences.
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.
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.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-26 UTC."],[[["\u003cp\u003eThe Google Mobile Ads C++ SDK is deprecated and will be end-of-maintenance on June 17, 2025; developers should use the iOS or Android SDKs instead.\u003c/p\u003e\n"],["\u003cp\u003eThe SDK allows specifying desired creative types for test queries using the \u003ccode\u003eft_ctype\u003c/code\u003e parameter in test mode.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is applicable to Google ads only and may result in more no fills due to restricted ad availability.\u003c/p\u003e\n"],["\u003cp\u003eValid \u003ccode\u003eft_ctype\u003c/code\u003e values include \u003ccode\u003ehtml5\u003c/code\u003e, \u003ccode\u003eimage_app_install\u003c/code\u003e, \u003ccode\u003eimage_display\u003c/code\u003e, \u003ccode\u003epartial_slot\u003c/code\u003e, \u003ccode\u003etext_app_install\u003c/code\u003e, \u003ccode\u003etext_display\u003c/code\u003e, \u003ccode\u003etrueview\u003c/code\u003e, and \u003ccode\u003evideo_app_install\u003c/code\u003e, each corresponding to specific creative types and ad formats.\u003c/p\u003e\n"],["\u003cp\u003eFor support, consult the Google Mobile Ads SDK Technical Forum.\u003c/p\u003e\n"]]],["The Google Mobile Ads C++ SDK is deprecated as of June 17, 2024, and will reach End-of-Maintenance on June 17, 2025; use iOS or Android SDKs instead. In Test Mode, the `ft_ctype` parameter can be added to ad requests to retrieve only specified creative types. Valid `ft_ctype` values include `html5`, `image_app_install`, `video_app_install`, and others, each corresponding to a specific format. This parameter only affects Google ads.\n"],null,["# Test creative types\n\n| **DEPRECATED:** The Google Mobile Ads C++ SDK is *deprecated* as of June 17, 2024 and should not be adopted in projects that don't already use it. It will enter *End-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.\n|\n| Instead of the Google Mobile Ads C++ SDK, consider using the\n| [iOS](/admob/ios/quick-start) and\n| [Android](/admob/android/quick-start) SDKs from AdMob.\n| For support, reach out to the\n| [Google Mobile Ads SDK Technical Forum](https://groups.google.com/g/google-admob-ads-sdk).\n\n\u003cbr /\u003e\n\n\nGoogle Mobile Ads SDK\n\nprovides an API that lets you specify a creative type\nfor test queries. When the parameter is set, only creatives of the specified\ntype are retrieved and rendered.\n\nUsage\n-----\n\nTo specify a creative type, include the `ft_ctype` parameter in an extras object\nand pass it to the ad request. This may restrict which ads are available and\nresult in no fill.\n**Note:** The `ft_ctype` parameter only works in [Test Mode](/admob/cpptest-ads#enable_test_devices). \n\n### Android\n\n AdRequest ad_request;\n\n ad_request.add_extra(\n /*adapter_class_name=*/\"com.google.ads.mediation.admob.AdMobAdapter\",\n /*extra_key=*/\"ft_ctype\",\n /*extra_value=*/\"video_app_install\");\n\n### iOS\n\n AdRequest ad_request;\n\n ad_request.add_extra(\n /*adapter_class_name=*/\"GADExtras\",\n /*extra_key=*/\"ft_ctype\",\n /*extra_value=*/\"video_app_install\");\n\nThe following table lists the valid values for `ft_ctype`:\n\n| Creative Type | ft_ctype | Format |\n|----------------------|-------------------|----------------------------------------|\n| HTML5 | html5 | Banner, Interstitial, Rewarded |\n| App install image | image_app_install | Banner, Native, Interstitial, Rewarded |\n| Display image | image_display | Banner, Interstitial |\n| Display partial slot | partial_slot | Banner, Native, Interstitial |\n| App install text | text_app_install | Banner, Native, Interstitial |\n| Display text | text_display | Banner, Native, Interstitial |\n| Trueview | trueview | Interstitial, Rewarded |\n| App install video | video_app_install | Banner, Native, Interstitial, Rewarded |\n\nThis feature impacts Google ads only. If your ad unit enables\n[mediation](/admob/cppmediation), ads returned from third-party ad sources don't\nrespect the `ft_ctype` parameter. We recommend testing with an ad unit that\ndoesn't have mediation enabled."]]