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

# BrandsAdGroupReportResponse

The top-level response envelope for brands ad group reports.

## Declaration

```data
object BrandsAdGroupReportResponse
```

## Properties

result: Wraps the array of report rows, each containing the ad group metadata (including targeting configuration) and performance metrics segmented by the requested groupBy dimensions. If no rows match the request, result is returned as an empty object. See BrandsAdGroupResultContainer for details. pagination: Returned for paging through large result sets. See ResponsePagination for details. error: See ErrorResponse for details.

## Discussion

Discussion The brands ad group reports support groupBy dimensions deviceClass, locationId, and supplyPlacement. Example {   "result": {     "rows": [       {         "metadata": {           "id": 555666888,           "name": "AwayFinder - SF Metro Locations",           "adAccountId": 123456789,           "campaignId": 444555999,           "status": "ENABLED",           "deleted": false,           "locationId": "loc-002"         },         "totalMetrics": {           "localSpend": {             "amount": "4200.00",             "currency": "USD"           },           "impressions": 420000,           "taps": 8400,           "ttr": 0.02         },         "granularMetrics": [           {             "date": "2025-01-10",             "localSpend": {               "amount": "420.00",               "currency": "USD"             },             "impressions": 42000,             "taps": 840           }         ]       }     ],     "summary": {       "grandTotal": {         "localSpend": {           "amount": "4200.00",           "currency": "USD"         },         "impressions": 420000,         "taps": 8400       }     }   },   "pagination": {     "offset": 0,     "pageSize": 20,     "totalCount": 1   } }

## See Also

- [BrandsReportingRequest](apple-ads-platform-api/brandsreportingrequest.md)
- [BrandsReportingCampaign](apple-ads-platform-api/brandsreportingcampaign.md)
- [BrandsReportingAdGroup](apple-ads-platform-api/brandsreportingadgroup.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)
- [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)