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

# AppsReportingAdGroup

Ad group metadata for apps report rows.

## Declaration

```data
object AppsReportingAdGroup
```

## Properties

id: The ad group’s unique identifier. campaignId: The campaign this ad group belongs to. adAccountId: The ad account this ad group belongs to. name: The ad group name as configured at report time. status: Possible values: ENABLED, PAUSED. deleted: Whether the ad group has been soft-deleted. systemStatus: Possible values: RUNNING, NOT_RUNNING. systemStatusReasons: System-applied reasons contributing to the current systemStatus. systemStatusLimitingReasons: Status-limiting reasons applied based on advertiser and system factors. automatedKeywordsOptIn: Whether the ad group opted in to automated keywords. automatedKeywordsRequired: Whether automated keywords are required for this ad group. pricingModel: Possible values: CPA, CPM, CPT. displayStatus: System-computed, rolled-up delivery state combining ad group and campaign conditions. modificationTime: Timestamp of the ad group’s last modification (ISO 8601). creationTime: Timestamp when the ad group was created (ISO 8601). startTime: Ad group start time. endTime: Ad group end time. campaign: See ReportingCampaignMin for details. cpaCap: CPA cap amount. See ReportingMoney for details. bidStrategy: See ReportingBidStrategy for details. countryOrRegion: Country or region groupBy dimension value. deviceClass: Device class groupBy dimension value. gender: Gender groupBy dimension value. ageRange: Age range groupBy dimension value. locality: Locality groupBy dimension value. countryCode: Country code groupBy dimension value. adminArea: Administrative area groupBy dimension value.

## Discussion

Discussion The AppsReportingAdGroup object is the ad group metadata embedded in apps ad group report rows. It captures the ad group’s configuration at report time, including its pricingModel (CPA, CPM, or CPT) and bidStrategy. The campaign field provides a lightweight ReportingCampaignMin summary for quick access to the parent campaign context. The response populates the dimension fields (countryOrRegion, deviceClass, gender, ageRange, locality, countryCode, adminArea) based on which groupBy dimensions you specify in the report request. Each populated dimension field generates one report row per unique value of that dimension. Example {   "id": 555666777,   "campaignId": 123456789,   "adAccountId": 987654321,   "name": "AwayFinder - Search Ad Group",   "status": "ENABLED",   "deleted": false,   "systemStatus": "RUNNING",   "systemStatusReasons": [],   "systemStatusLimitingReasons": [],   "automatedKeywordsOptIn": false,   "automatedKeywordsRequired": false,   "pricingModel": "CPT",   "displayStatus": "RUNNING",   "modificationTime": "2025-01-10T08:00:00.000",   "creationTime": "2025-01-05T08:00:00.000",   "startTime": "2025-01-05T08:00:00.000",   "endTime": null,   "campaign": {},   "cpaCap": {     "value": {       "amount": "5.00",       "currency": "USD"     }   },   "bidStrategy": {     "bidStrategyType": "MANUAL_CPT",     "bid": {       "amount": "2.50",       "currency": "USD"     }   },   "countryOrRegion": "US",   "deviceClass": "IPHONE",   "gender": "M",   "ageRange": "25-34",   "locality": "San Francisco",   "countryCode": "US",   "adminArea": "CA" }

## Topics

### Type Aliases

- [AppsReportingAdGroup.PricingModel](apple-ads-platform-api/appsreportingadgroup/pricingmodel-data.typealias.md)
- [AppsReportingAdGroup.Status](apple-ads-platform-api/appsreportingadgroup/status-data.typealias.md)
- [AppsReportingAdGroup.SystemStatus](apple-ads-platform-api/appsreportingadgroup/systemstatus-data.typealias.md)

## See Also

- [AppsReportingRequest](apple-ads-platform-api/appsreportingrequest.md)
- [AppsReportingCampaign](apple-ads-platform-api/appsreportingcampaign.md)
- [AppsReportingAd](apple-ads-platform-api/appsreportingad.md)
- [AppsReportingCreative](apple-ads-platform-api/appsreportingcreative.md)
- [AppsCampaignReportResponse](apple-ads-platform-api/appscampaignreportresponse.md)
- [AppsCampaignReportRow](apple-ads-platform-api/appscampaignreportrow.md)
- [AppsCampaignReportSummary](apple-ads-platform-api/appscampaignreportsummary.md)
- [AppsCampaignResultContainer](apple-ads-platform-api/appscampaignresultcontainer.md)
- [AppsAdGroupReportResponse](apple-ads-platform-api/appsadgroupreportresponse.md)
- [AppsAdGroupReportRow](apple-ads-platform-api/appsadgroupreportrow.md)
- [AppsAdGroupReportSummary](apple-ads-platform-api/appsadgroupreportsummary.md)
- [AppsAdGroupResultContainer](apple-ads-platform-api/appsadgroupresultcontainer.md)
- [AppsAdReportResponse](apple-ads-platform-api/appsadreportresponse.md)
- [AppsAdReportRow](apple-ads-platform-api/appsadreportrow.md)
- [AppsAdReportSummary](apple-ads-platform-api/appsadreportsummary.md)