測試廣告素材類型
    
    
      
    
    
      
      透過集合功能整理內容
    
    
      
      你可以依據偏好儲存及分類內容。
    
  
    
  
      
    
  
  
  
  
  
    
    
    
  
  
    
    
    
  
  
  
  
  
    
    
      
    
      
    
  
  
您可以使用 Google Mobile Ads SDK 提供的 API,為測試查詢指定廣告素材類型。設定好參數之後,就只會擷取並顯示您所指定的廣告素材。
用量
如要指定廣告素材類型,請在 extras 物件中加入 ft_ctype 參數,並傳遞至廣告請求。這可能會限制可用的廣告,導致無法放送廣告。
 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();
 
下表列出 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-10-14 (世界標準時間)。
  
  
  
    
      [[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-10-14 (世界標準時間)。"],[],["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"]]