---
title: AdGroupTargetingUpdate
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/adgrouptargetingupdate
---

# AdGroupTargetingUpdate

The targeting configuration for updating an existing ad group, specifying audience dimensions to include or exclude.

## Declaration

```data
object AdGroupTargetingUpdate
```

## Properties

country: Country-level geographic targeting. Include a country ID returned by the Geo Search API. See TargetingDataUpdate. adminArea: Administrative area (state or province) targeting. Include admin area IDs returned by the Geo API. See TargetingDataUpdate. locality: City or locality targeting. Include locality IDs returned by the Geo API. See TargetingDataUpdate. postalCode: Postal code geographic targeting. Include postal code IDs returned by the Geo API. See TargetingDataUpdate. radius: Radius targeting for Apple Maps campaigns. Valid values: CLOSE, MEDIUM, FAR. In practice, radius targeting applies only to MAPS_SEARCH_RESULTS campaigns. Avoid combining it with geo location targeting, though the API doesn’t enforce this constraint at the schema level. See TargetingDataUpdate. deviceClass: Device class targeting (for example, IPHONE, IPAD). See TargetingDataUpdate. minAge: Minimum age targeting for the audience. Minimum value is 18, maximum value is 64. See TargetingDataUpdate. maxAge: Maximum age targeting for the audience. Minimum value is 18, maximum value is 64. To target users 65 and older, omit maxAge or send include as null. See TargetingDataUpdate. gender: Gender targeting for the audience. Valid values: M, F. See TargetingDataUpdate. appCategory: App category targeting based on App Store categories. Category ID 100 is a special value representing the same category as the promoted app. A value of 100 in include means you’re targeting apps in the same category as your app, and a value of 100 in exclude means you aren’t. See TargetingDataUpdate. appDownloader: Reach or suppress users based on whether they’ve downloaded specific apps. Use include to reach users who have downloaded those apps. Use exclude to suppress users who already have your app (acquisition targeting). Use the adamId of the app you’re promoting in your campaign as an included or excluded value; API users can only pass in their own apps. To target all users, don’t include this dimension in the request payload. See TargetingDataUpdate. daypart: Time-of-day targeting (dayparting). Include-only. The API doesn’t support the exclude array for this dimension. Values are slot integers (0–167). For the full slot reference, see AdGroupTargeting. See TargetingDataUpdate. locationGroup: Location group targeting for Apple Maps campaigns. See TargetingDataUpdate.

## Overview

Overview For valid location identifier values and geographic lookup, see Geo Targeting Endpoints.

## Topics

### Dictionaries

- [AdGroupTargetingUpdate.AdminArea](apple-ads-platform-api/adgrouptargetingupdate/adminarea-data.dictionary.md)
- [AdGroupTargetingUpdate.AppCategory](apple-ads-platform-api/adgrouptargetingupdate/appcategory-data.dictionary.md)
- [AdGroupTargetingUpdate.AppDownloader](apple-ads-platform-api/adgrouptargetingupdate/appdownloader-data.dictionary.md)
- [AdGroupTargetingUpdate.Country](apple-ads-platform-api/adgrouptargetingupdate/country-data.dictionary.md)
- [AdGroupTargetingUpdate.Daypart](apple-ads-platform-api/adgrouptargetingupdate/daypart-data.dictionary.md)
- [AdGroupTargetingUpdate.DeviceClass](apple-ads-platform-api/adgrouptargetingupdate/deviceclass-data.dictionary.md)
- [AdGroupTargetingUpdate.Gender](apple-ads-platform-api/adgrouptargetingupdate/gender-data.dictionary.md)
- [AdGroupTargetingUpdate.Locality](apple-ads-platform-api/adgrouptargetingupdate/locality-data.dictionary.md)
- [AdGroupTargetingUpdate.LocationGroup](apple-ads-platform-api/adgrouptargetingupdate/locationgroup-data.dictionary.md)
- [AdGroupTargetingUpdate.MaxAge](apple-ads-platform-api/adgrouptargetingupdate/maxage-data.dictionary.md)
- [AdGroupTargetingUpdate.MinAge](apple-ads-platform-api/adgrouptargetingupdate/minage-data.dictionary.md)
- [AdGroupTargetingUpdate.PostalCode](apple-ads-platform-api/adgrouptargetingupdate/postalcode-data.dictionary.md)
- [AdGroupTargetingUpdate.Radius](apple-ads-platform-api/adgrouptargetingupdate/radius-data.dictionary.md)

## See Also

- [AdGroup](apple-ads-platform-api/adgroup.md)
- [AdGroupCreate](apple-ads-platform-api/adgroupcreate.md)
- [AdGroupUpdate](apple-ads-platform-api/adgroupupdate.md)
- [AdGroupResponse](apple-ads-platform-api/adgroupresponse.md)
- [AdGroupQueryResponse](apple-ads-platform-api/adgroupqueryresponse.md)
- [AdGroupTargeting](apple-ads-platform-api/adgrouptargeting.md)
- [AdGroupTargetingCreate](apple-ads-platform-api/adgrouptargetingcreate.md)
- [BidStrategy](apple-ads-platform-api/bidstrategy.md)
- [BidStrategyCreate](apple-ads-platform-api/bidstrategycreate.md)
- [BidStrategyUpdate](apple-ads-platform-api/bidstrategyupdate.md)
- [CPAGoal](apple-ads-platform-api/cpagoal.md)
- [CPAGoalCreate](apple-ads-platform-api/cpagoalcreate.md)
- [CPAGoalUpdate](apple-ads-platform-api/cpagoalupdate.md)
- [TargetingData](apple-ads-platform-api/targetingdata.md)
- [TargetingDataCreate](apple-ads-platform-api/targetingdatacreate.md)