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

# BrandsMetrics

Metrics for brands promoted object type.

## Declaration

```data
object BrandsMetrics
```

## Properties

date: Report date in YYYY-MM-DD format. localSpend: Total spend. See Money. impressions: Total ad impressions. taps: Total ad taps. ttr: Tap-through rate. cpt: Average cost per tap. See Money. cpm: Average cost per thousand impressions. See Money. firstActions: First-time action counts. See ActionMetrics. firstActionsPerTap: First-action rates per tap. See RateMetrics. firstActionsPerImpression: First-action rates per impression. See RateMetrics. costPerFirstAction: Cost per first action. See CostMetrics. actions: Total action counts. See ActionMetrics. costPerAction: Cost per action. See CostMetrics. getDirections: Get-directions action counts. See ActionMetrics. tapURL: Tap-URL action counts. See ActionMetrics. call: Call action counts. See ActionMetrics. share: Share action counts. See ActionMetrics. getTheApp: Get-the-app action counts. See ActionMetrics. galleryEngagement: Gallery engagement action counts. See ActionMetrics. actionsPerTap: Total actions per tap rate. See RateMetrics. actionsPerImpression: Total actions per impression rate. See RateMetrics.

## Discussion

Discussion The BrandsMetrics object is the base metrics for brands campaign reports. It includes spend, impression, and tap metrics shared with apps, plus brands-specific engagement actions (get directions, tap URL, call, share, get the app, gallery engagement) and their associated rate and cost breakdowns. All action count fields reference ActionMetrics objects. Cost fields reference CostMetrics. Rate fields reference RateMetrics. Monetary spend fields reference Money. Example {   "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   } }

## 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)