Stay organized with collections
Save and categorize content based on your preferences.
Next Gen 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-09-04 UTC."],[[["\u003cp\u003eThe Google Mobile Ads SDK allows specifying a creative type for test queries using the \u003ccode\u003eft_ctype\u003c/code\u003e parameter.\u003c/p\u003e\n"],["\u003cp\u003eSetting the \u003ccode\u003eft_ctype\u003c/code\u003e parameter in an extras object of the ad request will only return and render creatives of the specified type.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eft_ctype\u003c/code\u003e parameter is only applicable in Test Mode and does not impact reservation inventory or third-party mediation sources.\u003c/p\u003e\n"],["\u003cp\u003eValid values for \u003ccode\u003eft_ctype\u003c/code\u003e include options such as "html5", "image_app_install", "video_app_install", and more, each with specific format compatibility.\u003c/p\u003e\n"]]],[],null,["Next Gen Mobile Ads SDK provides 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\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/android/early-access/nextgen/test-ads#enable_test_devices). \n\nKotlin \n\n val extras = Bundle()\n extras.putString(\"ft_ctype\", \"video_app_install\")\n\n val request = AdRequest\n .Builder(\u003cvar class=\"readonly\" translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eAD_UNIT_ID\u003c/span\u003e\u003c/var\u003e)\n .setGoogleExtrasBundle(extras)\n .build()\n\nJava \n\n Bundle extras = new Bundle();\n extras.putString(\"ft_ctype\", \"video_app_install\");\n\n AdRequest request = new AdRequest\n .Builder(\u003cvar class=\"readonly\" translate=\"no\"\u003e\u003cspan class=\"devsite-syntax-n\"\u003eAD_UNIT_ID\u003c/span\u003e\u003c/var\u003e)\n .setGoogleExtrasBundle(extras)\n .build();\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/android/early-access/nextgen/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."]]