Contents

SpendRow

The reporting response metrics.

Declaration

object SpendRow

Properties

NameTypeDescription
avgCPMMoney

The average CPM is the average amount you pay per one thousand ad impressions.

avgCPTMoney

The average cost-per-tap (CPT) is the ratio of spend over taps.

impressionsint64

The number of times your ad appears in App Store search results within the reporting period.

localSpendMoney

The total spend of a campaign in the currency the organization uses.

tapInstallCPIMoney

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.

tapInstallRatedouble

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.

tapInstallsint64

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.

tapNewDownloadsint64

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.

tapRedownloadsint64

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.

tapsint64

The number of times people tap your ad within the reporting period.

tapPreOrdersPlacedint64

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.

totalAvgCPIMoney

The total campaign spend divided by the total number of installs within the reporting period.

totalInstallRatedouble

The total number of installs divided by the total number of taps within the reporting period.

totalInstallsint64

The total number of tap-through and view-through new downloads and redownloads within the reporting period.

totalNewDownloadsint64

The total number of tap-through and view-through new downloads within the reporting period.

totalRedownloadsint64

The total number of tap-through and view-through redownloads within the reporting period.

totalPreOrdersPlacedint64

The total number of tap-through and view-through pre-orders placed resulting from an ad within the reporting period.

ttrdouble

The tap-through rate (TTR) is the number of times people tap your ad divided by the total impressions your ad receives.

viewInstallsint64

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.

viewNewDownloadsint64

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.

viewPreOrdersPlacedint64

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.

viewRedownloadsint64

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

See Also

Reports Request and Response Objects