<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/AdGroupTargeting",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:AdGroupTargeting"
  },
  "title" : "AdGroupTargeting"
}
-->

# AdGroupTargeting

The comprehensive audience and placement configuration for an ad group.

```
object AdGroupTargeting
```

## Discussion

The `AdGroupTargeting` object is the comprehensive audience and placement configuration for an ad group. The [`CampaignTargeting`](/documentation/Apple-Ads-Platform-API/CampaignTargeting) establishes campaign-level supply source, placement, and geographic markets first, and `AdGroupTargeting` then refines audience and delivery within the bounds of that campaign.

Each field uses a `TargetingData` object with `include` and `exclude` arrays. Setting `exclude` on an include-only dimension has no effect.

Not every targeting dimension is meaningful for every campaign type in practice. The API represents every dimension as the same generic `TargetingData` shape, so campaign-type pairing is usage guidance rather than a constraint the schema enforces.

Combining multiple dimensions uses AND logic: a user must match all specified criteria to be eligible.

For valid location identifier values and geographic lookup, see [Geo Targeting Endpoints](/documentation/Apple-Ads-Platform-API/geo-targeting-endpoints). For managing location groups used in `locationGroup` targeting, see [Managing Location Groups](/documentation/Apple-Ads-Platform-API/location-groups-overview).

For a full request that embeds `targeting` alongside the other ad group fields, see [`Create an Ad Group`](/documentation/Apple-Ads-Platform-API/POST-adgroups) (create) and [`Update an Ad Group`](/documentation/Apple-Ads-Platform-API/PUT-adgroups-_id_) (update).

### Example

> Note: This example shows every available targeting dimension for illustration. In practice, include only the dimensions relevant to your campaign type, with values customized to your targeting needs.

```json
{
  "country": {
    "include": ["1125", "1107"]
  },
  "adminArea": {
    "include": ["9070", "12683"]
  },
  "locality": {
    "include": ["11390462"]
  },
  "postalCode": {
    "include": ["11412181", "11412183"]
  },
  "radius": {
    "include": ["MEDIUM"]
  },
  "deviceClass": {
    "include": ["IPHONE", "IPAD"]
  },
  "minAge": {
    "include": ["25"]
  },
  "maxAge": {
    "include": ["54"]
  },
  "gender": {
    "include": ["M", "F"]
  },
  "appCategory": {
    "include": ["100"],
    "exclude": ["100"]
  },
  "appDownloader": {
    "include": ["987654321"],
    "exclude": ["555666777"]
  },
  "daypart": {
    "include": ["8", "9", "10", "32", "33", "34"]
  },
  "locationGroup": {
    "include": ["123456789"]
  }
}
```

## Topics

### Dictionaries

[`object AdGroupTargeting.AdminArea`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting/AdminArea-data.dictionary)

State or province (administrative area) targeting.

[`object AdGroupTargeting.AppCategory`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting/AppCategory-data.dictionary)

App category targeting based on App Store categories, with include and exclude support.

[`object AdGroupTargeting.AppDownloader`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting/AppDownloader-data.dictionary)

The defined targeted audience according to app downloads.

[`object AdGroupTargeting.Country`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting/Country-data.dictionary)

Country-level geographic targeting.

[`object AdGroupTargeting.Daypart`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting/Daypart-data.dictionary)

Hour-of-day targeting, restricting delivery to specific one-hour slots in a 7-day week grid.

[`object AdGroupTargeting.DeviceClass`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting/DeviceClass-data.dictionary)

Device class targeting (for example, `IPHONE` or `IPAD`).

[`object AdGroupTargeting.Gender`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting/Gender-data.dictionary)

Gender targeting for the audience.

[`object AdGroupTargeting.Locality`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting/Locality-data.dictionary)

City or locality targeting.

[`object AdGroupTargeting.LocationGroup`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting/LocationGroup-data.dictionary)

Location group targeting, restricting delivery to the business locations in specified groups.

[`object AdGroupTargeting.MaxAge`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting/MaxAge-data.dictionary)

Maximum age targeting, setting the upper bound of the target age range.

[`object AdGroupTargeting.MinAge`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting/MinAge-data.dictionary)

Minimum age targeting, setting the lower bound of the target age range.

[`object AdGroupTargeting.PostalCode`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting/PostalCode-data.dictionary)

Postal code geographic targeting.

[`object AdGroupTargeting.Radius`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting/Radius-data.dictionary)

Radius targeting used with Apple Maps campaigns to restrict delivery to users within a given proximity of the brand’s locations.

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)