測試廣告素材類型
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
您可以使用 Google Mobile Ads SDK 提供的 API,為測試查詢指定廣告素材類型。設定好參數之後,就只會擷取並顯示您所指定的廣告素材。
用量
如要指定廣告素材類型,請在 extras 物件中加入 ft_ctype
參數,並傳遞至廣告請求。這可能會限制可用的廣告,導致無法放送廣告。
Swift
let extras = Extras()
extras.additionalParameters = ["ft_ctype": "video_app_install"]
let request = Request()
request.register(extras)
Objective-C
GADExtras *extras = [[GADExtras alloc] init];
extras.additionalParameters = @{@"ft_ctype" : @"video_app_install"};
GADRequest *request = [GADRequest request];
[request registerAdNetworkExtras:extras];
下表列出 ft_ctype
的有效值:
廣告素材類型 |
ft_ctype |
格式 |
HTML5 |
HTML5 |
橫幅、插頁式、獎勵 |
應用程式安裝圖像 |
image_app_install |
橫幅、原生、插頁式、獎勵 |
多媒體圖像 |
image_display |
橫幅、插頁式 |
顯示部分版位 |
partial_slot |
橫幅、原生、插頁式 |
應用程式安裝文字 |
text_app_install |
橫幅、原生、插頁式 |
顯示文字 |
text_display |
橫幅、原生、插頁式 |
TrueView |
trueview |
插頁式、獎勵 |
應用程式安裝影片 |
video_app_install |
橫幅、原生、插頁式、獎勵 |
這項功能只會影響 Google 廣告。如果廣告單元啟用中介服務,從第三方廣告來源傳回的廣告就不會遵守 ft_ctype
參數。建議您只對未啟用中介服務的廣告單元進行測試。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-09-02 (世界標準時間)。
[null,null,["上次更新時間:2025-09-02 (世界標準時間)。"],[[["\u003cp\u003eGoogle Mobile Ads SDK allows you to specify a desired creative type for test queries using the \u003ccode\u003eft_ctype\u003c/code\u003e request parameter.\u003c/p\u003e\n"],["\u003cp\u003eThis parameter helps to retrieve and render only specific creative types like video, image, or HTML5 during testing.\u003c/p\u003e\n"],["\u003cp\u003eThis feature is only functional in Test Mode and impacts Google ads, not ads from third-party networks through mediation.\u003c/p\u003e\n"],["\u003cp\u003eUsing the \u003ccode\u003eft_ctype\u003c/code\u003e parameter can potentially increase the chances of encountering no fills due to ad restrictions.\u003c/p\u003e\n"],["\u003cp\u003eSeveral creative types including video_app_install, html5, and image_app_install can be specified using the \u003ccode\u003eft_ctype\u003c/code\u003e parameter.\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 during the ad request. This parameter limits the retrieved and rendered ads to the specified type, which may reduce the available ads. Valid `ft_ctype` values include `html5`, `image_app_install`, and `video_app_install`, amongst others, with different supported formats. This feature only works in Test Mode and solely impacts Google ads. Mediation ads do not respect this parameter.\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/ios/test-ads#enable_test_devices). \n\nSwift \n\n let extras = Extras()\n extras.additionalParameters = [\"ft_ctype\": \"video_app_install\"]\n\n let request = Request()\n request.register(extras)\n\nObjective-C \n\n GADExtras *extras = [[GADExtras alloc] init];\n extras.additionalParameters = @{@\"ft_ctype\" : @\"video_app_install\"};\n\n GADRequest *request = [GADRequest 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](/admob/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."]]