---
title: AdGroupCreate.Targeting
framework: Apple Ads Platform API
role: symbol
role_heading: Object
platforms: [apple ads platform api 1.0+]
path: apple-ads-platform-api/adgroupcreate/targeting-data.dictionary
---

# AdGroupCreate.Targeting

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

## Declaration

```data
object AdGroupCreate.Targeting
```

## 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 or as an empty array ([]). 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 users who have downloaded specific apps. 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.

## Discussion

Discussion Defines the audience dimensions, such as geography, demographics, device, and behavior, to include or exclude when creating this ad group. The daypart dimension is include-only and doesn’t support exclude. See AdGroupTargetingCreate for the full field reference.
