First-time downloads, units and total downloads: which is which
They come from two different reports and they count different things. First-time downloads are new Apple Accounts only — a person who has never had the app before. Total downloads adds redownloads on top. Units, in the sales report, are transactions, and most of them are not downloads at all. If you are trying to answer “how many new people got my app”, first-time downloads is the only one of the three that answers it.
What each one counts
| Figure | Report | Counts | Excludes |
|---|---|---|---|
| First-time downloads | Analytics: App Downloads | An Apple Account downloading the app for the first time | Redownloads, manual updates, auto-updates, restores |
| Total downloads | Analytics: App Downloads | First-time downloads plus redownloads | Updates |
| Units | Sales and Trends | Transaction rows: paid downloads, in-app purchases, subscriptions, refunds | Updates and redownloads appear but carry no proceeds |
Why your sales report looks nothing like your download chart
A sales report row is a transaction, not an install. On a free app, most rows are free downloads worth nothing. Updates and redownloads appear as their own product types, carry no proceeds, and must never be counted as downloads — a reader who sums every unit in the sales report ends up counting every update as an install, which on an app with a loyal user base can dwarf the real figure.
The two reports also disagree about what a day is. Analytics days are in UTC; Sales and Trends days are in Pacific Time. The same download and the money from it can fall on different dates.
Does the API match Apple's dashboard?
For first-time downloads, yes. We reconciled the App Store Connect API against App Analytics for a steady iOS app and a low-volume macOS app over a week in November 2026, and first-time downloads matched exactly, every day, for both. Product page views matched exactly too, once the definition was right — see below.
Impressions are the one metric that does not match. That has its own guide: why API impressions read lower than App Store Connect.
The definition that catches people out: product page views
Apple's App Analytics figure for product page views is Product page + Store sheet — the full page, and the sheet that slides up when someone taps your app inside another app. Count only the first and you are permanently a little short. App privacy, Developer page, App version history, In-app event and Media view are separate page types and are not product page views.
We had this wrong by one view for a week until the Store sheet rows were included, at which point the figure matched Apple's dashboard every day for a month.
What to use when
- “How many new people got my app?” — first-time downloads.
- “How many installs happened?” — total downloads, if you care about people reinstalling.
- “How much did I earn?” — proceeds, not units. See sales, proceeds and currencies.
- Never sum sales-report units to get downloads.
AppStato shows first-time downloads by that definition, labels the report and the time zone each figure came from, and keeps updates and redownloads out of the download count entirely.See AppStato.