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

# TargetingData

The shared include and exclude pattern for all ad group and campaign targeting dimensions.

```
object TargetingData
```

## Discussion

The `TargetingData` object is the shared include/exclude pattern for all ad group targeting dimensions. The `include` array restricts delivery to the specified values. The `exclude` array blocks delivery to those values. When you set both arrays, `include` takes precedence over `exclude` for overlapping values.

- **Not all dimensions support both arrays.** For `AdGroupTargeting`, only `appCategory` and `appDownloader` support both `include` and `exclude`. All other ad group targeting dimensions are include-only.
- For `CampaignTargeting`, all three dimensions (`supplySource`, `supplyPlacement`, `countryOrRegion`) are include-only. See the per-dimension support table in [`AdGroupTargeting`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting).

This object is embedded within [`CampaignTargeting`](/documentation/Apple-Ads-Platform-API/CampaignTargeting) fields `supplySource`, `supplyPlacement`, and `countryOrRegion`, which control the ad channel, placement, and geographic markets for a campaign.

The [`AdGroupTargeting`](/documentation/Apple-Ads-Platform-API/AdGroupTargeting) also embeds `TargetingData` within fields such as `country`, `deviceClass`, `gender`, `minAge`, and others, which refine audience and delivery within that campaign. The valid values for each field depend on the targeting dimension: `supplySource` accepts `APPSTORE` and `MAPS`. The `deviceClass` field accepts `IPHONE` and `IPAD`.

### Example

```json
{
  "include": [
    "APPSTORE"
  ],
  "exclude": [
    "MAPS"
  ]
}
```

---

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)