---
title: SpendRow
framework: Apple Ads
role: symbol
role_heading: Object
platforms: [search ads 2.0+]
path: apple_ads/spendrow
---

# SpendRow

The reporting response metrics.

## Declaration

```data
object SpendRow
```

## Properties

avgCPM: The average CPM is the average amount you pay per one thousand ad impressions. avgCPT: The average cost-per-tap (CPT) is the ratio of spend over taps. impressions: The number of times your ad appears in App Store search results within the reporting period. localSpend: The total spend of a campaign in the currency the organization uses. tapInstallCPI: Prior to API 5, this was the avgCPA field. The total campaign spend divided by the number of tap-through installs within the reporting period. tapInstallRate: Prior to API 5, this was the conversionRate field. The total number of tap-through installs divided by the total number of taps within the reporting period. tapInstalls: Prior to API 5, this was the installs field. The total number of new downloads and redownloads from people who tapped your ad within a 30-day attribution window. tapNewDownloads: Prior to API 5, this was the newDownloads field. New downloads from people who tapped your ad within a 30-day attribution window. The API counts new downloads when someone downloads your app to a device where your app hasn’t previously been installed. tapRedownloads: Prior to API 5, this was the redownloads field. Redownloads from people who tapped your ad within a 30-day attribution window. The API counts redownloads when someone downloads your app, deletes it, and downloads it again on the same device, or a different one, following an ad tap. taps: The number of times people tap your ad within the reporting period. tapPreOrdersPlaced: The total number of pre-orders placed by users who tapped your ad. A pre-order placed (tap-through) is counted when a user has tapped your ad and authenticated with Face ID, Touch ID, or their passcode to allow the app to be downloaded on release day, within a 30-day window of the ad tap, and within 60 days of the app download. This does not account for any pre-orders canceled after the pre-order has been placed. totalAvgCPI: The total campaign spend divided by the total number of installs within the reporting period. totalInstallRate: The total number of installs divided by the total number of taps within the reporting period. totalInstalls: The total number of tap-through and view-through new downloads and redownloads within the reporting period. totalNewDownloads: The total number of tap-through and view-through new downloads within the reporting period. totalRedownloads: The total number of tap-through and view-through redownloads within the reporting period. totalPreOrdersPlaced: The total number of tap-through and view-through pre-orders placed resulting from an ad within the reporting period. ttr: The tap-through rate (TTR) is the number of times people tap your ad divided by the total impressions your ad receives. viewInstalls: The total number of new downloads and redownloads from people who viewed your ad, but didn’t tap it, within a 1-day attribution window. viewNewDownloads: New downloads from people who viewed your ad, but didn’t tap it, within a 1-day attribution window. The API counts new downloads when someone downloads your app to a device where your app hasn’t previously been installed. viewPreOrdersPlaced: The total number of pre-orders placed from users who viewed your ad, but didn’t tap it. A pre-order placed (view-through) is counted within 24 hours of viewing your ad, and within 60 days of the app download. This does not account for any pre-orders canceled after the pre-order has been placed. viewRedownloads: Redownloads from people who viewed your ad, but didn’t tap it, within a 1-day attribution window. The API counts redownloads when someone downloads your app, deletes it, and downloads it again on the same device, or a different one, following an ad view.

## Mentioned in

Apple Ads Campaign Management API 2 Apple Ads Campaign Management API 5

## See Also

### Reports Request and Response Objects

- [ReportingRequest](apple_ads/reportingrequest.md)
- [ReportingResponseBody](apple_ads/reportingresponsebody.md)
- [ReportingResponse](apple_ads/reportingresponse.md)
- [ReportingDataResponse](apple_ads/reportingdataresponse.md)
- [GrandTotalsRow](apple_ads/grandtotalsrow.md)
- [ExtendedSpendRow](apple_ads/extendedspendrow.md)
- [Row](apple_ads/row.md)
- [ReportingCampaign](apple_ads/reportingcampaign.md)
- [ReportingAdGroup](apple_ads/reportingadgroup.md)
- [ReportingKeyword](apple_ads/reportingkeyword.md)
- [ReportingSearchTerm](apple_ads/reportingsearchterm.md)
- [ReportingAd](apple_ads/reportingad.md)
- [CampaignAppDetail](apple_ads/campaignappdetail.md)
- [InsightsObject](apple_ads/insightsobject.md)
- [KeywordInsights](apple_ads/keywordinsights.md)