Analytics Reports
A list of app development reports, their field descriptions, and glossaries.
Overview
Use the Analytics Report API to analyze data about your apps on Apple platforms. This page provides details on downloading reports, report changes, and a list of available reports. You can look at specific reports to read descriptions of report fields, glossaries of values, definitions of key terms, and coverage across platforms.
You can review these reports if you have any of these API key roles:
ADMINSALES_AND_REPORTSFINANCE
Download and process reports
To start receiving reports, use the Request reports endpoint in the App Store Connect API. To learn more, see Downloading Analytics Reports. After you create your request, use Read report request information to poll the list of report instances to check whether new instances are downloadable. Apple does not generate reports until you create a valid Analytics Report Request.
Each report instance represents a new set of data. Each instance can consist of multiple segments, which are physical partitions of one instance, so you need to download all segments for a given instance to get the complete set of data.
Each report instance has a specific granularity: daily, weekly, or monthly. Daily instances may contain data for one day or more days. The Date column in the report content shows the day to which the events relate. Weekly instances contain data from Monday to Sunday. Monthly instances contain data for a full month. To learn more, see Data Completeness and Corrections.
Retrieve missed reports
Once you generate a report instance, it’s available for 35 days. After this period, the system automatically deletes report instances. In that event, you are able to initiate a new one-time snapshot request using the Request reports endpoint in App Store Connect API to retrieve data that is no longer available in a daily generated report. This request generates a comprehensive data collection of all available historical reports. You can make a single, one-time snapshot request per month.
Monitor future report changes
Report column position might change over time. Rely on column names instead of column positions in the report files to ensure smoother schema upgrades. Report values are not case sensitive.
Topics
Essentials
App Store Engagement
App Store Commerce
App Store DownloadsApp Store Pre-ordersApp Store PurchasesApp Store Subscription StateApp Store Subscription Event
App Usage
App Clip UsageApp CrashesApp Store Installations and DeletionsApp Store Opt-inApp SessionsCarPlay App UsagePlatform App InstallsShortcut App UsageShortcuts Actions Usage
Framework Usage
AccessorySetupKit Accessory Picker SessionsAccessorySetupKit UsageAirPlay Discovery SessionsAnimoji Stickers SentApp Added to FocusApp Disk Space UsageApp Extended Launch UsageApp HangTracer UsageApp Runtime UsageApp Sessions ContextApplication Preferred Language SettingsARKit ARSession DurationARKit ARSession FailuresARKit Capture Frame Rate ThrottlingARKit Collaborative Session FeaturesARKit Face TrackingARKit Video FormatsARKit World TrackingARKit World Tracking Image DetectionAudio Input MutingAudio Input Route and Duration and Call ModeAudio Session Audio Unit UsageAudio Volume Levels and DurationAutomatic Speech Recognition UsageBluetooth LE AdvertisingBluetooth LE Connection ResultsBluetooth LE Connections Per AppBluetooth LE Disconnection ResultsBluetooth LE ScansBluetooth LE SessionsBrowser Choice Screen Engagement (iOS versions before 18.2)Browser Choice Screen SelectionCall Services and Call PerformanceCarPlay NavigationCollaboration Message UsageCore Location Authorization ResultsCore Location GeofencingCRABS-Based Video Playback UsageCustom Language Model Builds StartedCustomized Transcription RequestsDefault Browser Usage RateDockKit App UsageDynamic Island Layout ChangesFace-Driven Auto Exposure and Auto Focus UsageFile-Based Video Playback UsageFile-System Events API UsageFlashlight UsageGame Controller Haptics Engine CreationGame Controller SessionsHaptics Engine UsageHome Screen Widget InstallsHome Screen Widget RotationsHome Screen Widget UsageHome Screen WidgetsHTTP Live Streaming Playback CountHTTP Live Streaming Video Playback UsageiBeacon Add Region UsageiBeacon Ranging UsageiBeacon Stop Monitoring for Region UsageKeyboard Dictation UsageLive Activity UseLoad CoreML Models MetricsLocal Network PrivacyLocation SessionsLock Screen Widget ConfigurationMetal Command QueuesMode Activity NotificationsMultiple Game Controllers UsageNearby Interaction SessionsNotification Summary EngagementPhoto Capture UsagePhotogrammetry ObjectCaptureSession API UsagePhotogrammetrySession API UsagePhotoKit ImportsPhotos Library AccessPhotos PickerPhotos SharingProRes Video UsageReminders UsageRoomPlan UsageSafari Extensions EnablementSafari Extensions UsageShared With You Content EngagementSharePlay Usage by Activity TypeShazamKit UsageSpatial Audio UsageSpeech Framework Transcription Request Audio DurationSpeech Framework Transcription RequestsText-Input ActionsTranslation Request UsageVerify With Wallet Document Request AvailabilityVerify with Wallet Document RequestsVideo Duration InformationVideo PiP DurationVideo Streaming DurationVisionKit Data DetectorsVisionKit Image AnalysisVisionKit Live Text UsageVisionKit SessionsWi-Fi Known Network Modifications
Performance
AirPlay ErrorsAirPlay PerformanceApp Crashes ExpandedApp Installs PerformanceApp Neural FootprintApp Storage Reads and WritesAudio OverloadsBluetooth LE Session DurationBluetooth System WakesCAMetalLayer PerformanceCellular Plan ProvisioningCustom Language Model Builds FailedDisplay Power InformationEmbedding GenerationHTTP Live Streaming Playback ErrorsLaunch Image Over Memory LimitNetworking Connection ActivitySpotlight Query PerformanceStreaming Downloads PerformanceStreaming Playback Performance