<!--
{
  "availability" : [
    "Apple Ads Platform API: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Apple-Ads-Platform-API",
  "identifier" : "/documentation/Apple-Ads-Platform-API/BrandsMetrics",
  "metadataVersion" : "0.1.0",
  "role" : "Object",
  "symbol" : {
    "kind" : "Object",
    "modules" : [
      "Apple Ads Platform API"
    ],
    "preciseIdentifier" : "data:apple-ads-platform-api:BrandsMetrics"
  },
  "title" : "BrandsMetrics"
}
-->

# BrandsMetrics

Metrics for brands promoted object type.

```
object BrandsMetrics
```

## 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`](/documentation/Apple-Ads-Platform-API/ActionMetrics) objects. Cost fields reference [`CostMetrics`](/documentation/Apple-Ads-Platform-API/CostMetrics). Rate fields reference [`RateMetrics`](/documentation/Apple-Ads-Platform-API/RateMetrics). Monetary spend fields reference [`Money`](/documentation/Apple-Ads-Platform-API/Money).

### Example

```json
{
  "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
  }
}
```

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)