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-08-26 UTC."],[[["\u003cp\u003eThe Google Mobile Ads SDK allows specifying a creative type for test queries using the \u003ccode\u003eft_ctype\u003c/code\u003e parameter, which restricts the retrieved and rendered creatives to the designated type.\u003c/p\u003e\n"],["\u003cp\u003eTo use this feature, include the \u003ccode\u003eft_ctype\u003c/code\u003e parameter in an extras object and pass it to the ad request, though this may limit available ads.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eft_ctype\u003c/code\u003e parameter is exclusively for use in Test Mode and does not affect third-party ads from mediation sources.\u003c/p\u003e\n"],["\u003cp\u003eValid values for \u003ccode\u003eft_ctype\u003c/code\u003e 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 different creative types and formats.\u003c/p\u003e\n"],["\u003cp\u003eThe provided code samples in Kotlin and Java demonstrate how to correctly implement the \u003ccode\u003eft_ctype\u003c/code\u003e parameter with an \u003ccode\u003eAdRequest\u003c/code\u003e via an \u003ccode\u003eextras\u003c/code\u003e object.\u003c/p\u003e\n"]]],["The Google Mobile Ads SDK allows specifying a creative type for test queries using the `ft_ctype` parameter within an extras object in the ad request. This parameter restricts retrieved and rendered creatives to the specified type, potentially resulting in no fill. Valid `ft_ctype` values include `html5`, `image_app_install`, `image_display`, `partial_slot`, `text_app_install`, `text_display`, `trueview`, and `video_app_install`. This parameter only works in Test Mode and impacts Google ads, not mediated third-party ads.\n"],null,["# Test creative types\n\nNext Gen 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/android/early-access/nextgen/test-ads#enable_test_devices). \n\n### Kotlin\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\n### Java\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](/admob/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."]]