---
title: TargetingDimensions
framework: Apple Ads
role: symbol
role_heading: Object
platforms: [search ads 2.0+]
path: apple_ads/targetingdimensions
---

# TargetingDimensions

The optional criteria to use with ad groups to narrow the audience that views your ads.

## Declaration

```data
object TargetingDimensions
```

## Properties

adminArea: The dimension to target users by adminArea. An adminArea is a state or the equivalent according to its associated country. Use Search for Geolocations with entity to search for and retrieve geolocations. Then use geotargeting dimensions country, adminArea, and locality in the TargetingDimensions payload with the Create an Ad Group  and Update an Ad Group endpoints. age: The dimension to target users by age demographic. Limit the age group you want to show your ad to. You must set a minimum age. To include multiple ranges, input them as a list.**** appCategories: The dimension to include target audience by app category. Only applicable to campaigns using a SupplySource of APPSTORE_PRODUCT_PAGES_BROWSE. See the App Store for more details about categories. appDownloaders: The dimension to include users who have downloaded your app or to exclude users who haven’t downloaded your app. Each campaign can promote only one app per adamId. country: The dimension to target users by country or region. Use Search for Geolocations with entity to search for and retrieve geolocations. Then use geotargeting dimensions country, adminArea, and locality in the TargetingDimensions payload with the Create an Ad Group  and Update an Ad Group endpoints. For the country dimension, use a single country code in an ISO alpha-2 country code format. Campaigns that serve multiple countries or regions can’t use geotargeting. Use UpdateCampaignRequest to clear geotargeting from a campaign. daypart: The dimension to target users by a specific time of day. Numbers ranging from 0 to 167 represent the hours of a week beginning at Sunday 12:00 midnight. For example, the hour beginning Monday at 1:00 a.m. is 25. deviceClass: The dimension to target users by device class. This defaults to the device classes that the promoted app supports. gender: The dimension to target users by gender demographic. Specify the gender you want to show your ad to. To specify all genders, set the value to null. locality: The dimension to target users by locality. A locality is a city or the equivalent according to its associated adminArea. See Search for Geolocations to retrieve geolocations.

## Discussion

Discussion Specify targeting criteria in the TargetingDimensions object and apply it to ad groups using Create an Ad Group  and Update an Ad Group endpoints.

## See Also

### Audience Refinement

- [AppCategoryCriteria](apple_ads/appcategorycriteria.md)
- [AppDownloaderCriteria](apple_ads/appdownloadercriteria.md)
- [AdminAreaCriteria](apple_ads/adminareacriteria.md)
- [CountryCriteria](apple_ads/countrycriteria.md)
- [LocalityCriteria](apple_ads/localitycriteria.md)
- [AgeCriteria](apple_ads/agecriteria.md)
- [AgeRange](apple_ads/agerange.md)
- [DaypartCriteria](apple_ads/daypartcriteria.md)
- [DaypartDetail](apple_ads/daypartdetail.md)
- [DeviceClassCriteria](apple_ads/deviceclasscriteria.md)
- [GenderCriteria](apple_ads/gendercriteria.md)