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

# BrandsAdReportRow

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

## Declaration

```data
object BrandsAdReportRow
```

## Properties

totalMetrics: See BrandsMetrics 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 BrandsReportingAd for details.

## Discussion

Discussion The BrandsAdReportRow object is the brands counterpart to AppsAdReportRow. It uses BrandsMetrics, a richer metric set than the apps metrics that includes Maps location-action fields such as getDirections, call, and share alongside the standard impression and tap metrics. The metadata field captures ad 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": 210000,     "taps": 5200,     "ttr": 0.0247,     "cpt": {       "amount": "0.16",       "currency": "USD"     },     "cpm": {       "amount": "4.03",       "currency": "USD"     },     "firstActions": {       "tap": 1300     },     "firstActionsPerTap": {       "tap": 0.25     },     "firstActionsPerImpression": {       "tap": 0.0062     },     "costPerFirstAction": {       "tap": {         "amount": "0.65",         "currency": "USD"       }     },     "actions": {       "tap": 2100     },     "costPerAction": {       "tap": {         "amount": "0.40",         "currency": "USD"       }     },     "getDirections": {       "tap": 620     },     "tapURL": {       "tap": 410     },     "call": {       "tap": 180     },     "share": {       "tap": 95     },     "getTheApp": {       "tap": 540     },     "galleryEngagement": {       "tap": 255     },     "actionsPerTap": {       "tap": 0.40     },     "actionsPerImpression": {       "tap": 0.01     }   },   "granularMetrics": [     {       "date": "2025-01-10",       "localSpend": {         "amount": "845.50",         "currency": "USD"       },       "impressions": 210000,       "taps": 5200,       "ttr": 0.0247,       "cpt": {         "amount": "0.16",         "currency": "USD"       },       "cpm": {         "amount": "4.03",         "currency": "USD"       },       "firstActions": {         "tap": 1300       },       "firstActionsPerTap": {         "tap": 0.25       },       "firstActionsPerImpression": {         "tap": 0.0062       },       "costPerFirstAction": {         "tap": {           "amount": "0.65",           "currency": "USD"         }       },       "actions": {         "tap": 2100       },       "costPerAction": {         "tap": {           "amount": "0.40",           "currency": "USD"         }       },       "getDirections": {         "tap": 620       },       "tapURL": {         "tap": 410       },       "call": {         "tap": 180       },       "share": {         "tap": 95       },       "getTheApp": {         "tap": 540       },       "galleryEngagement": {         "tap": 255       },       "actionsPerTap": {         "tap": 0.40       },       "actionsPerImpression": {         "tap": 0.01       }     }   ],   "metadata": {     "id": 555666777,     "name": "AwayFinder - Brands Ad",     "deleted": false,     "status": "ENABLED",     "systemStatus": "RUNNING",     "systemStatusReasons": [],     "systemStatusLimitingReasons": [],     "adAccountId": 123456789,     "campaignId": 987654321,     "adGroupId": 456789123,     "creationTime": "2025-01-10T08:00:00.000",     "modificationTime": "2025-01-10T08:00:00.000",     "displayStatus": "RUNNING",     "creative": {       "id": 321654987,       "creativeType": "LOCAL_ADS_SEARCH_CREATIVE",       "systemStatus": "VALID"     },     "deviceClass": "IPHONE",     "locationId": "location-98765",     "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)
- [BrandsAdGroupReportRow](apple-ads-platform-api/brandsadgroupreportrow.md)
- [BrandsAdGroupReportSummary](apple-ads-platform-api/brandsadgroupreportsummary.md)
- [BrandsAdGroupResultContainer](apple-ads-platform-api/brandsadgroupresultcontainer.md)