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-25 UTC."],[[["\u003cp\u003eThe Google Mobile Ads SDK allows you to specify a desired creative type for test queries using the \u003ccode\u003eft_ctype\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eThis feature only works in Test Mode and primarily affects Google Ads, not third-party networks via mediation.\u003c/p\u003e\n"],["\u003cp\u003eSpecifying a creative type may lead to more no fills as it restricts the available ads for the request.\u003c/p\u003e\n"],["\u003cp\u003eReservation inventory and backfill-only ad units might not be completely affected by the \u003ccode\u003eft_ctype\u003c/code\u003e parameter during testing.\u003c/p\u003e\n"],["\u003cp\u003eYou can find a table of valid creative types and corresponding \u003ccode\u003eft_ctype\u003c/code\u003e values within the documentation.\u003c/p\u003e\n"]]],["The Google Mobile Ads SDK allows specifying a creative type for test ad queries using the `ft_ctype` parameter within an extras object in the ad request. This parameter filters ads to display only the chosen creative type, like \"video_app_install.\" Valid types include HTML5, various image and text-based app installs/displays, trueview and partial slot. This feature is limited to test mode and impacts only Google ads, not reservation inventory or third-party ad sources through mediation, which should be disabled for testing.\n"],null,["# Test creative types\n\nSelect platform: [Android](/ad-manager/mobile-ads-sdk/android/test-creative-types \"View this page for the Android platform docs.\") [iOS](/ad-manager/mobile-ads-sdk/ios/test-creative-types \"View this page for the iOS platform docs.\")\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| **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.\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](/ad-manager/mobile-ads-sdk/ios/test-ads#enable_test_devices). \n\n### Swift\n\n let extras = Extras()\n extras.additionalParameters = [\"ft_ctype\": \"video_app_install\"]\n\n let request = AdManagerRequest()\n request.register(extras)\n\n### Objective-C\n\n GADExtras *extras = [[GADExtras alloc] init];\n extras.additionalParameters = @{@\"ft_ctype\" : @\"video_app_install\"};\n\n GAMRequest *request = [GAMRequest request];\n [request registerAdNetworkExtras:extras];\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](/ad-manager/mobile-ads-sdk/ios/mediation), 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."]]
