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

# AdGroup

Primary unit governing targeting, bid strategy, pricing model, and scheduling within a campaign.

```
object AdGroup
```

## Discussion

An `AdGroup` is the primary unit for governing ad delivery within a campaign. Multiple ad groups within a campaign allow different targeting strategies, bids, and schedules to compete and optimize within the same promoted app or brand.

Fields you can filter and sort on when querying ad groups are listed in [`Query Ad Groups`](/documentation/Apple-Ads-Platform-API/POST-adgroups-query).

### Example

```json
{
  "id": 555666777,
  "name": "AwayFinder iOS — New Users 18-34",
  "adAccountId": 123456789,
  "campaignId": 444555666,
  "startTime": "2025-09-01T00:00:00.000",
  "endTime": "2025-12-31T23:59:59.000",
  "pricingModel": "CPT",
  "automatedKeywordsOptIn": false,
  "automatedKeywordsRequired": false,
  "status": "ENABLED",
  "systemStatus": "RUNNING",
  "systemStatusReasons": [],
  "systemStatusLimitingReasons": [],
  "displayStatus": "RUNNING",
  "bidStrategy": {
    "bidStrategyType": "MANUAL_CPT",
    "bidStrategyGoal": "TAP",
    "bid": {
      "amount": "5.00",
      "currency": "USD"
    }
  },
  "targeting": {
    "deviceClass": {
      "include": [
        "IPHONE"
      ]
    },
    "minAge": {
      "include": [
        "18"
      ]
    },
    "maxAge": {
      "include": [
        "34"
      ]
    },
    "appDownloader": {
      "include": [
        "123456789"
      ]
    }
  },
  "cpaCap": null,
  "deleted": false,
  "creationTime": "2025-01-10T08:00:00.000",
  "modificationTime": "2025-01-10T08:00:00.000"
}
```

## Topics

### Dictionaries

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

Defines how this ad group competes in auctions, including bid type, optimization goal, and bid amount.

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

A deprecated cost-per-acquisition goal value. Use `bidStrategy` with `MAX_CONVERSIONS` instead.

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

The comprehensive audience and placement configuration for an ad group.

### Type Aliases

[`string AdGroup.DisplayStatus`](/documentation/Apple-Ads-Platform-API/AdGroup/DisplayStatus-data.typealias)

Derived display status for an ad group, combining advertiser-set status with system status.

[`string AdGroup.PricingModel`](/documentation/Apple-Ads-Platform-API/AdGroup/PricingModel-data.typealias)

The unit of ad delivery an ad group is charged for, independent of how the account funds spend.

[`string AdGroup.Status`](/documentation/Apple-Ads-Platform-API/AdGroup/Status-data.typealias)

Advertiser-configurable serving status for an ad group.

[`string AdGroup.SystemStatus`](/documentation/Apple-Ads-Platform-API/AdGroup/SystemStatus-data.typealias)

System-derived operational status reflecting whether an ad group is actively serving.

[`string AdGroup.SystemStatusLimitingReasons`](/documentation/Apple-Ads-Platform-API/AdGroup/SystemStatusLimitingReasons-data.typealias)

Reasons that limit delivery for an ad group without fully stopping it.

[`string AdGroup.SystemStatusReasons`](/documentation/Apple-Ads-Platform-API/AdGroup/SystemStatusReasons-data.typealias)

Reasons that can cause an ad group’s system status to be `NOT_RUNNING`.

---

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)