Measure your first annual installs

If you have accepted the Alternative Terms Addendum for Apps in the EU (available for apps in the European Union), you'll begin accumulating first annual installs for your EU apps.

Use the following two reports to monitor how many first annual installs your apps receive. If any of your apps exceed one million first annual installs, or if you're distributing an app marketplace, you’ll also receive monthly financial reports which will inform you of the amount owed. Nonprofit organizations, accredited educational institutions, and government entities who are approved for a fee waiver will also receive the first annual install reports but not the financial report since they are exempt from the Core Technology Fee, subject to the Apple Developer Program’s existing rules.

If you have not signed the Alternative Terms Addendum, you can use App Install Reports from 2023 to estimate your Core Technology Fee.

Report Name				Description								Availability
First Annual Install Detailed Report				Provides first annual installs and total installs by territory, channel, install type, and OS version.								Daily
First Annual Install Summary Report				Provides a rolling 12 month snapshot of first annual installs, installs above the threshold, and total installs by app.								Monthly

First annual install types

Install type descriptions, and whether they may be counted as a first annual install.

Scenario	Description	Can be a first annual install
First-time install	The first time an app is installed onto a device by an Apple Account account.	Yes
Re-install	A subsequent installation of an app onto a device by an Apple Account account.	Yes
App update	The process of replacing an app on a device with another version of the same app. Includes auto-updates.	Yes
App bundle	A group of apps made available together as a single download.	Yes
App Clip	A small part of an app that lets you do a task quickly, like rent a bike, pay for parking, or order food.	Yes
TestFlight app installs and updates	Pre-release versions of your app.	Yes
Installs from Apple Business Manager	An App Store program that enables businesses to easily buy and distribute content.	Yes
Installs from Apple School Manager	An App Store program that enables schools to easily buy and distribute content.	Yes
Installs of unlisted apps	Apps that are discoverable only with a direct link, and don't appear in any App Store categories, recommendations, charts, search results, or other listings.	Yes
Installs from Apple Configurator	A software application that enables users to quickly configure large numbers of devices.	Yes
iOS app with Watch app	iOS apps with watchOS extensions.	Yes
Standalone iMessage/Stickers apps	Installs of standalone iMessage apps or sticker packs downloaded from the App Store for iMessage.	Yes
Installs of Enterprise apps	Proprietary, internal-use apps developed and deployed by large organizations in the Apple Developer Enterprise Program.	No
App installs on iPadOS, tvOS, macOS, visionOS, or watchOS	Apps installed on Apple platforms other than iOS.	No
Auto-installs	The process of automatically installing an iOS app onto a device other than where the app was manually installed. Controlled by the device's settings.	No
iCloud transfers	The process of installing an app onto a fresh device from iCloud Backup, where the app has been previously installed by the associated Apple Account account.	No
Demo accounts	Downloads associated with an account provided to Apple for App Store review purposes only.	No
Internal testing / Xcode	Installs of apps directly from Xcode.	No
Retail accounts	An account created and used for use in Apple Retail stores.	No
Reinstalls of an offloaded app	Reinstallations of apps that were offloaded in order to save space on the device.	No

First Annual Install Detailed Report

Report Field
App Identifier	Int	The identifier of the app that was installed.
App Name	String	The name of the app that was installed.
Territory	String	The territory in which the install occured.
Channel	String	The channel from which the install was initiated.
Install Type	String	The type of install that occured.
OS Version	String	The OS version on the device used to generate the install.
First Annual Installs (Month-to-Date)	Int	The number of first annual installs so far in the month associated with the report.
Total Installs (Month-to-Date)	Int	The number of total installs so far in the month associated with the report.

First Annual Install Summary Report

Report Field
Reporting Date	Date	The associated date for this report.
Developer Name	String	The provider name provided by you during the initial account setup.
App Identifier	Int	The identifier of the app that was installed.
App Name	String	The name of the app that was installed.
Installs Above Threshold	Int	The number of first annual installs that qualify for a fee.
12 Month Total	Int	The number of first annual installs in the last 12 months.
MM YYYY	Int	The number of first annual installs for the month and year displayed in the column title.
Total Installs	Int	The total number of installs received in the last 12 months.

FAQs

How does Apple know how many installs my apps are getting?

Apple provides secure installation APIs that can be called by the App Store, web distribution developers, or alternative app marketplaces to request the installation of iOS and/iPadOS apps. This API, along with a signal when the installation is complete, enables Apple to accurately count how many times an app is installed.

How will Apple protect developers from install spam?

Apple already takes a number of steps to prevent fraud and scams and protect developers’ intellectual property. Apple is implementing additional measures to monitor, detect, and prevent install abuse, including:

An install verification mechanism to ensure that all installs come from real Apple devices.
Limits on the number of first annual installs that can come from a single device.
Investigating, and potentially terminating, user or developer accounts that engage in suspicious behavior.

If a developer believes that their app’s install count was inflated by install spam, they’ll be able to contact us.