> [!WARNING]
> **DEPRECATED:** The Google Mobile Ads C++ SDK is *deprecated* as of June 17, 2024 and should not be adopted in projects that don't already use it. It will enter *End-of-Maintenance (EoM)* on June 17, 2025. Note that versions of the SDK released before the EoM date will continue to function, but no further bug fixes or changes will be released after the EoM date.
>
> Instead of the Google Mobile Ads C++ SDK, consider using the
> [iOS](https://developers.google.com/admob/ios/quick-start.md.txt) and
> [Android](https://developers.google.com/admob/android/quick-start.md.txt) SDKs from AdMob.
> For support, reach out to the
> [contact us form](https://support.google.com/admob/contact/contact_us_gma_sdk).

<br />

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.

> [!NOTE]
> **Note:** The `ft_ctype` parameter only works in [Test Mode](https://developers.google.com/admob/cpptest-ads#enable_test_devices).

### Android

```c++
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");
```

### iOS

```c++
AdRequest ad_request;

ad_request.add_extra(
  /*adapter_class_name=*/"GADExtras",
  /*extra_key=*/"ft_ctype",
  /*extra_value=*/"video_app_install");
```

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](https://developers.google.com/admob/cppmediation), 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.