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

# AdGroupTargetingCreate

The targeting configuration for creating a new ad group, specifying audience dimensions to include or exclude.

## Declaration

```data
object AdGroupTargetingCreate
```

## Properties

country: Country-level geographic targeting. Include a country ID returned by the Geo Search API. See TargetingDataCreate. adminArea: Administrative area (state or province) targeting. Include admin area IDs returned by the Geo API. See TargetingDataCreate. locality: City or locality targeting. Include locality IDs returned by the Geo API. See TargetingDataCreate. postalCode: Postal code geographic targeting. Include postal code IDs returned by the Geo API. See TargetingDataCreate. radius: Radius targeting, used with Apple Maps campaigns. Valid values: CLOSE, MEDIUM, FAR. In practice, radius targeting is applied on MAPS_SEARCH_RESULTS campaigns and shouldn’t be combined with geo location targeting, but the API doesn’t enforce this constraint at the schema level. See TargetingDataCreate. deviceClass: Device class targeting (for example, IPHONE, IPAD). See TargetingDataCreate. minAge: Minimum age targeting for the audience. Minimum value is 18, maximum value is 64. See TargetingDataCreate. 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 TargetingDataCreate. gender: Gender targeting for the audience. Valid values: M, F. See TargetingDataCreate. 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 TargetingDataCreate. 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 TargetingDataCreate. daypart: Time-of-day targeting (dayparting). Include-only. The exclude array isn’t supported for this dimension. Values are slot integers (0–167). For the full slot reference, see AdGroupTargeting. See TargetingDataCreate. locationGroup: Location group targeting for Apple Maps campaigns. See TargetingDataCreate.

## Overview

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

## Topics

### Dictionaries

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