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

# BrandsReportingAdGroup

Ad group metadata for brands report rows.

## Declaration

```data
object BrandsReportingAdGroup
```

## 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. bidStrategy: See ReportingBidStrategy for details. targeting: See BrandsTargetingProjection for details. deviceClass: Device class groupBy dimension value. locationId: Location ID groupBy dimension value. supplyPlacement: Supply placement groupBy dimension value.

## Discussion

Discussion The BrandsReportingAdGroup object is the ad group metadata embedded in brands ad group report rows. It captures configuration at report time, including the pricingModel, bidStrategy, and the brands-specific targeting projection with supply placement and location group details. The campaign field embeds a lightweight ReportingCampaignMin for parent campaign context. The system populates the brands dimension fields (deviceClass, locationId, supplyPlacement) based on the groupBy dimensions in the report request. Note that keyword and search term entities exclude supplyPlacement and locationId as groupBy options. Example {   "id": 123456789,   "campaignId": 987654321,   "adAccountId": 555666777,   "name": "AwayFinder - Brands Ad Group",   "status": "ENABLED",   "deleted": false,   "systemStatus": "RUNNING",   "systemStatusReasons": ["PROCESSING"],   "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": "2025-06-30T08:00:00.000",   "campaign": {},   "bidStrategy": {     "bidStrategyType": "MANUAL_CPT",     "bid": {       "amount": "2.50",       "currency": "USD"     }   },   "targeting": {     "supplyPlacement": {       "include": ["MAPS_SEARCH_RESULTS", "MAPS_SEARCH_HOME"]     },     "lifetimeStorefronts": {       "include": ["US", "CA"]     },     "supplySource": {       "include": ["MAPS"]     },     "promotedLocationGroup": {       "include": ["555666777"]     },     "promotedLocation": {       "include": ["123456789"]     }   },   "deviceClass": "IPHONE",   "locationId": "123456789",   "supplyPlacement": "MAPS_SEARCH_RESULTS" }

## Topics

### Type Aliases

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

## See Also

- [BrandsReportingRequest](apple-ads-platform-api/brandsreportingrequest.md)
- [BrandsReportingCampaign](apple-ads-platform-api/brandsreportingcampaign.md)
- [BrandsReportingAd](apple-ads-platform-api/brandsreportingad.md)
- [BrandsReportingCreative](apple-ads-platform-api/brandsreportingcreative.md)
- [BrandsReportingKeyword](apple-ads-platform-api/brandsreportingkeyword.md)
- [BrandsReportingSearchTerm](apple-ads-platform-api/brandsreportingsearchterm.md)
- [BrandsCampaignReportResponse](apple-ads-platform-api/brandscampaignreportresponse.md)
- [BrandsCampaignReportRow](apple-ads-platform-api/brandscampaignreportrow.md)
- [BrandsCampaignReportSummary](apple-ads-platform-api/brandscampaignreportsummary.md)
- [BrandsCampaignResultContainer](apple-ads-platform-api/brandscampaignresultcontainer.md)
- [BrandsAdGroupReportResponse](apple-ads-platform-api/brandsadgroupreportresponse.md)
- [BrandsAdGroupReportRow](apple-ads-platform-api/brandsadgroupreportrow.md)
- [BrandsAdGroupReportSummary](apple-ads-platform-api/brandsadgroupreportsummary.md)
- [BrandsAdGroupResultContainer](apple-ads-platform-api/brandsadgroupresultcontainer.md)
- [BrandsAdReportResponse](apple-ads-platform-api/brandsadreportresponse.md)