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

# BrandsAdGroupReportRow

A single row in a Brands (Apple Maps) ad group report, pairing ad group metadata with total and granular performance metrics.

## Declaration

```data
object BrandsAdGroupReportRow
```

## Properties

totalMetrics: See BrandsAdGroupMetrics for details. granularMetrics: Time-series metrics broken down by the requested granularity (for example, DAILY, WEEKLY). Present only when a granularity is specified in the request. When it isn’t, this field is absent and all data appears in totalMetrics instead. metadata: See BrandsReportingAdGroup for details.

## Discussion

Discussion The BrandsAdGroupReportRow object is the brands counterpart to AppsAdGroupReportRow. The metadata field captures ad group identifiers and configuration at report time. The totalMetrics field contains the aggregated performance figures across the full reporting period. Example {   "totalMetrics": {     "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"     },     "firstActions": {       "tap": 1450     },     "firstActionsPerTap": {       "tap": 0.1480     },     "firstActionsPerImpression": {       "tap": 0.0023     },     "costPerFirstAction": {       "tap": {         "amount": "0.58",         "currency": "USD"       }     },     "actions": {       "tap": 2100     },     "costPerAction": {       "tap": {         "amount": "0.40",         "currency": "USD"       }     },     "getDirections": {       "tap": 320     },     "tapURL": {       "tap": 610     },     "call": {       "tap": 145     },     "share": {       "tap": 95     },     "getTheApp": {       "tap": 780     },     "galleryEngagement": {       "tap": 150     },     "actionsPerTap": {       "tap": 0.2143     },     "actionsPerImpression": {       "tap": 0.0034     }   },   "granularMetrics": [     {       "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"       },       "firstActions": {         "tap": 1450       },       "firstActionsPerTap": {         "tap": 0.1480       },       "firstActionsPerImpression": {         "tap": 0.0023       },       "costPerFirstAction": {         "tap": {           "amount": "0.58",           "currency": "USD"         }       },       "actions": {         "tap": 2100       },       "costPerAction": {         "tap": {           "amount": "0.40",           "currency": "USD"         }       },       "getDirections": {         "tap": 320       },       "tapURL": {         "tap": 610       },       "call": {         "tap": 145       },       "share": {         "tap": 95       },       "getTheApp": {         "tap": 780       },       "galleryEngagement": {         "tap": 150       },       "actionsPerTap": {         "tap": 0.2143       },       "actionsPerImpression": {         "tap": 0.0034       }     }   ],   "metadata": {     "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"   } }

## 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)
- [BrandsAdGroupReportSummary](apple-ads-platform-api/brandsadgroupreportsummary.md)
- [BrandsAdGroupResultContainer](apple-ads-platform-api/brandsadgroupresultcontainer.md)
- [BrandsAdReportResponse](apple-ads-platform-api/brandsadreportresponse.md)