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

# LocalityCriteria

The defined targeted audience by locality.

## Declaration

```data
object LocalityCriteria
```

## Properties

included: The dimension to include targeted users by locality. For example, in the United States, a locality dimension is a city. This parameter doesn’t support the  excluded attribute. "locality": {       "included": [         "US|CA|Cupertino"       ]     },

## Discussion

Discussion A locality is a city or the equivalent according to its associated adminArea. Use the Search for Geolocations endpoint with the entity query parameter to search for and retrieve geolocations. Then use geotargeting dimensions country, adminArea, and locality with Create an Ad Group  and Update an Ad Group endpoints.

## See Also

### Audience Refinement

- [TargetingDimensions](apple_ads/targetingdimensions.md)
- [AppCategoryCriteria](apple_ads/appcategorycriteria.md)
- [AppDownloaderCriteria](apple_ads/appdownloadercriteria.md)
- [AdminAreaCriteria](apple_ads/adminareacriteria.md)
- [CountryCriteria](apple_ads/countrycriteria.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)