測試廣告素材類型
您可以使用 Google Mobile Ads SDK 提供的 API,為測試查詢指定廣告素材類型。設定好參數之後,就只會擷取並顯示指定類型的廣告素材。
用量
如要指定廣告素材類型,請在額外物件中加入 ft_ctype
參數,並將其傳遞至廣告要求。這可能會限制可用的廣告,導致無法放送廣告。
AdRequest ad_request;
ad_request.add_extra(
/*adapter_class_name=*/"com.google.ads.mediation.admob.AdMobAdapter",
/*extra_key=*/"ft_ctype",
/*extra_value=*/"video_app_install");
AdRequest ad_request;
ad_request.add_extra(
/*adapter_class_name=*/"GADExtras",
/*extra_key=*/"ft_ctype",
/*extra_value=*/"video_app_install");
下表列出 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-03-04 (世界標準時間)。
[null,null,["上次更新時間:2025-03-04 (世界標準時間)。"],[[["The Google Mobile Ads C++ SDK is deprecated and will be end-of-maintenance on June 17, 2025; developers should use the iOS or Android SDKs instead."],["The SDK allows specifying desired creative types for test queries using the `ft_ctype` parameter in test mode."],["This feature is applicable to Google ads only and may result in more no fills due to restricted ad availability."],["Valid `ft_ctype` values include `html5`, `image_app_install`, `image_display`, `partial_slot`, `text_app_install`, `text_display`, `trueview`, and `video_app_install`, each corresponding to specific creative types and ad formats."],["For support, consult the Google Mobile Ads SDK Technical Forum."]]],["The Google Mobile Ads C++ SDK is deprecated as of June 17, 2024, and will reach End-of-Maintenance on June 17, 2025; use iOS or Android SDKs instead. In Test Mode, the `ft_ctype` parameter can be added to ad requests to retrieve only specified creative types. Valid `ft_ctype` values include `html5`, `image_app_install`, `video_app_install`, and others, each corresponding to a specific format. This parameter only affects Google ads.\n"]]