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

# AppsMetrics

Metrics for apps promoted object type.

## Declaration

```data
object AppsMetrics
```

## Properties

date: Report date in YYYY-MM-DD format. localSpend: Total spend in the reporting period. See Money. impressions: Total ad impressions. taps: Total ad taps. ttr: Tap-through rate (taps divided by impressions). cpt: Average cost per tap. See Money. cpm: Average cost per thousand impressions. See Money. tapInstalls: Number of installs attributed to taps. tapInstallCPI: Average cost per tap-attributed install. See Money. totalNewDownloads: Total new downloads (first-time installs) across all attribution types. totalRedownloads: Total redownloads (installs of an app the user previously had installed, verified by the App Store) across all attribution types. viewInstalls: Number of installs attributed to view-through (impression-based) attribution. totalInstalls: Total installs combining tap and view attribution. tapNewDownloads: New downloads attributed to taps. tapRedownloads: Redownloads attributed to taps. viewNewDownloads: New downloads attributed to view-through impressions. viewRedownloads: Redownloads attributed to view-through impressions. totalAvgCPI: Average cost per install across all attribution types. See Money. totalInstallRate: Total install rate (total installs divided by taps). tapInstallRate: Tap install rate (tap installs divided by taps). tapPreOrdersPlaced: Pre-orders placed attributed to taps. viewPreOrdersPlaced: Pre-orders placed attributed to view-through impressions. totalPreOrdersPlaced: Total pre-orders placed across all attribution types.

## Discussion

Discussion The AppsMetrics object is the base metrics for apps campaign reports. It contains all standard performance metrics available for app promotion campaigns, including spend, impressions, taps, installs (split by tap-through and view-through attribution), pre-orders, and derived rates. All monetary fields reference Money objects in the account’s reporting currency. Example {   "date": "2025-01-10",   "localSpend": {     "amount": "482.50",     "currency": "USD"   },   "impressions": 152300,   "taps": 3210,   "ttr": 0.021,   "cpt": {     "amount": "0.15",     "currency": "USD"   },   "cpm": {     "amount": "3.17",     "currency": "USD"   },   "tapInstalls": 640,   "tapInstallCPI": {     "amount": "0.75",     "currency": "USD"   },   "totalNewDownloads": 710,   "totalRedownloads": 58,   "viewInstalls": 128,   "totalInstalls": 768,   "tapNewDownloads": 592,   "tapRedownloads": 48,   "viewNewDownloads": 118,   "viewRedownloads": 10,   "totalAvgCPI": {     "amount": "0.63",     "currency": "USD"   },   "totalInstallRate": 0.2393,   "tapInstallRate": 0.1994,   "tapPreOrdersPlaced": 22,   "viewPreOrdersPlaced": 4,   "totalPreOrdersPlaced": 26 }

## See Also

- [AppsReportingRequest](apple-ads-platform-api/appsreportingrequest.md)
- [AppsReportingCampaign](apple-ads-platform-api/appsreportingcampaign.md)
- [AppsReportingAdGroup](apple-ads-platform-api/appsreportingadgroup.md)
- [AppsReportingAd](apple-ads-platform-api/appsreportingad.md)
- [AppsReportingCreative](apple-ads-platform-api/appsreportingcreative.md)
- [AppsCampaignReportResponse](apple-ads-platform-api/appscampaignreportresponse.md)
- [AppsCampaignReportRow](apple-ads-platform-api/appscampaignreportrow.md)
- [AppsCampaignReportSummary](apple-ads-platform-api/appscampaignreportsummary.md)
- [AppsCampaignResultContainer](apple-ads-platform-api/appscampaignresultcontainer.md)
- [AppsAdGroupReportResponse](apple-ads-platform-api/appsadgroupreportresponse.md)
- [AppsAdGroupReportRow](apple-ads-platform-api/appsadgroupreportrow.md)
- [AppsAdGroupReportSummary](apple-ads-platform-api/appsadgroupreportsummary.md)
- [AppsAdGroupResultContainer](apple-ads-platform-api/appsadgroupresultcontainer.md)
- [AppsAdReportResponse](apple-ads-platform-api/appsadreportresponse.md)
- [AppsAdReportRow](apple-ads-platform-api/appsadreportrow.md)