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

# BrandsAdReportResponse

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

## Declaration

```data
object BrandsAdReportResponse
```

## Properties

result: Wraps the report rows, each including ad metadata (including creative type and the brands-specific groupBy dimensions deviceClass, locationId, and supplyPlacement) and associated performance metrics. If no rows match the request, result is returned as an empty object. See BrandsAdResultContainer for details. pagination: See ResponsePagination for details. error: See ErrorResponse for details.

## Discussion

Discussion Note that ad-level reports don’t support HOURLY granularity. Example {   "result": {     "rows": [       {         "totalMetrics": {           "date": "2025-01-10",           "localSpend": {             "amount": "845.50",             "currency": "USD"           },           "impressions": 620000,           "taps": 9800,           "ttr": 0.0158,           "cpt": {             "amount": "0.09",             "currency": "USD"           },           "cpm": {             "amount": "1.36",             "currency": "USD"           }         },         "granularMetrics": [],         "metadata": {           "id": 555666777,           "name": "AwayFinder - Brands Ad",           "deleted": false,           "status": "ENABLED",           "systemStatus": "RUNNING",           "adAccountId": 123456789,           "campaignId": 987654321,           "adGroupId": 111222333,           "creationTime": "2025-01-10T08:00:00.000",           "modificationTime": "2025-01-10T08:00:00.000",           "displayStatus": "RUNNING",           "creative": {             "creativeType": "LOCAL_ADS_SEARCH_CREATIVE"           },           "deviceClass": "IPHONE",           "locationId": 444555666,           "supplyPlacement": "MAPS_SEARCH_RESULTS"         }       }     ],     "summary": {       "grandTotal": {         "date": "2025-01-10",         "localSpend": {           "amount": "845.50",           "currency": "USD"         },         "impressions": 620000,         "taps": 9800,         "ttr": 0.0158,         "cpt": {           "amount": "0.09",           "currency": "USD"         },         "cpm": {           "amount": "1.36",           "currency": "USD"         }       }     }   },   "pagination": {     "pageSize": 20,     "offset": 0,     "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)
- [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)