Testare i tipi di creatività
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Seleziona la piattaforma:
Android
iOS
L'SDK Google Mobile Ads fornisce un'API che ti consente di specificare un tipo di creatività
per le query di test. Quando il parametro è impostato, vengono recuperate e sottoposte a rendering solo le creatività del tipo specificato.
Utilizzo
Per specificare un tipo di creatività, includi il parametro ft_ctype in un oggetto extra
e passalo alla richiesta di annuncio. Ciò potrebbe limitare gli annunci disponibili e
comportare l'assenza di riempimento.
Kotlin
val extras = Bundle()
extras.putString("ft_ctype", "video_app_install")
val request = AdRequest
.Builder()
.addNetworkExtrasBundle(AdMobAdapter::class.java, extras)
.build()
Java
Bundle extras = new Bundle();
extras.putString("ft_ctype", "video_app_install");
AdRequest request = new AdRequest
.Builder()
.addNetworkExtrasBundle(AdMobAdapter.class, extras)
.build();
La seguente tabella elenca i valori validi per ft_ctype:
| Tipo di creatività |
ft_ctype |
Formato |
| HTML5 |
HTML5 |
Banner, interstitial, con premio |
| Immagine per l'installazione di app |
image_app_install |
Banner, nativo, interstitial, con premio |
| Visualizza immagine |
image_display |
Banner, interstitial |
| Visualizza slot parziale |
partial_slot |
Banner, nativo, interstitial |
| Testo per l'installazione di app |
text_app_install |
Banner, nativo, interstitial |
| Testo visualizzato |
text_display |
Banner, nativo, interstitial |
| TrueView |
trueview |
Interstitial, con premio |
| Video per l'installazione di app |
video_app_install |
Banner, nativo, interstitial, con premio |
Questa funzionalità influisce solo sugli annunci Google. Se la tua unità pubblicitaria attiva la
mediazione, gli annunci restituiti dalle origini annuncio di terze parti non
rispettano il parametro ft_ctype. Ti consigliamo di eseguire i test con un'unità pubblicitaria
per cui non è stata attivata la mediazione.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-08-31 UTC.
[null,null,["Ultimo aggiornamento 2025-08-31 UTC."],[[["\u003cp\u003eThe Google Mobile Ads SDK allows you to specify a desired creative type for test queries, ensuring only creatives of that type are retrieved and rendered.\u003c/p\u003e\n"],["\u003cp\u003eTo use this feature, set the \u003ccode\u003eft_ctype\u003c/code\u003e request parameter within a bundle of extras in test mode, specifying the desired creative type like "video_app_install" or "html5".\u003c/p\u003e\n"],["\u003cp\u003eThis feature works with various creative types, formats, and ad units, as detailed in the provided table mapping creative types to their corresponding \u003ccode\u003eft_ctype\u003c/code\u003e values.\u003c/p\u003e\n"],["\u003cp\u003eWhile useful for testing, using \u003ccode\u003eft_ctype\u003c/code\u003e may increase the chance of no fills and only affects Google ads, not those from third-party ad networks through mediation.\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, passed to the ad request. This restricts ads to the defined type, potentially resulting in no fill. Valid `ft_ctype` values include `html5`, `image_app_install`, `video_app_install`, and others, each with supported formats (e.g., Banner, Interstitial). This parameter only works in test mode and impacts only Google ads, not third-party ads from mediated sources.\n"],null,["Select platform: [Android](/admob/android/test-creative-types \"View this page for the Android platform docs.\") [iOS](/admob/ios/test-creative-types \"View this page for the iOS platform docs.\")\n\n\u003cbr /\u003e\n\nGoogle 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\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](/admob/android/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()\n .addNetworkExtrasBundle(AdMobAdapter::class.java, 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()\n .addNetworkExtrasBundle(AdMobAdapter.class, 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/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."]]
