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

# AdGroup

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

## Declaration

```data
object AdGroup
```

## Properties

name: The advertiser-given name of this ad group. Mutable. adAccountId: The ad account this ad group belongs to. Read-only. campaignId: The campaign this ad group belongs to. Immutable after creation. startTime: Ad group schedule start time. ISO 8601 format, for example 2025-09-01T00:00:00.000. Mutable. endTime: Ad group schedule end time. ISO 8601 format, for example 2025-12-31T23:59:59.000. Mutable. pricingModel: The pricing model for this ad group. Values: CPA, CPM, CPT. See PricingModel. Immutable after creation. Must match the parent campaign’s billing event. automatedKeywordsOptIn: Opt in to Search Match, which automatically matches search terms without requiring explicit keywords. Mutable. status: Advertiser-configurable status for this ad group. See AdGroupStatus. Mutable. systemStatus: System-computed operational status reflecting the ad group’s current serving state. See AdGroupSystemStatus. Read-only. systemStatusReasons: System-applied reasons that contribute to the current systemStatus. See AdGroupSystemStatusReason for all values. Read-only. systemStatusLimitingReasons: System-applied reasons that limit delivery below maximum potential. See AdGroupSystemLimitedStatusReason for details. Read-only. automatedKeywordsRequired: Auto keyword generation required. Immutable after creation. displayStatus: System-computed, rolled-up delivery state combining status and systemStatus into a single delivery label, more intuitive than a binary running-or-not-running signal. See AdGroupDisplayStatus. Read-only. bidStrategy: The bid strategy for this ad group. If omitted, the campaign-level bid strategy applies. See BidStrategy. Mutable. targeting: Targeting configuration for this ad group. See AdGroupTargeting. Mutable. id: The unique identifier for this ad group. Read-only. creationTime: Timestamp when the ad group was created. Read-only. modificationTime: Timestamp of the last modification to the ad group. Read-only. deleted: Indicates if the ad group has been deleted. Read-only. cpaCap: Deprecated. Use bidStrategy with MAX_CONVERSIONS instead. See CPAGoal.

## Discussion

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. Example {   "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

- [AdGroup.BidStrategy](apple-ads-platform-api/adgroup/bidstrategy-data.dictionary.md)
- [AdGroup.CpaCap](apple-ads-platform-api/adgroup/cpacap-data.dictionary.md)
- [AdGroup.Targeting](apple-ads-platform-api/adgroup/targeting-data.dictionary.md)

### Type Aliases

- [AdGroup.DisplayStatus](apple-ads-platform-api/adgroup/displaystatus-data.typealias.md)
- [AdGroup.PricingModel](apple-ads-platform-api/adgroup/pricingmodel-data.typealias.md)
- [AdGroup.Status](apple-ads-platform-api/adgroup/status-data.typealias.md)
- [AdGroup.SystemStatus](apple-ads-platform-api/adgroup/systemstatus-data.typealias.md)
- [AdGroup.SystemStatusLimitingReasons](apple-ads-platform-api/adgroup/systemstatuslimitingreasons-data.typealias.md)
- [AdGroup.SystemStatusReasons](apple-ads-platform-api/adgroup/systemstatusreasons-data.typealias.md)

## See Also

- [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)
- [AdGroupTargetingCreate](apple-ads-platform-api/adgrouptargetingcreate.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)