# 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: - `ADMIN` - `SALES_AND_REPORTS` - `FINANCE` > If you share an API key for your developer account with a third party for analyzing or processing your reports, select the SALES_AND_REPORTS role when generating a new key. This role can access to but can’t access endpoint. ### Download and process reports To start receiving reports, use the endpoint in the App Store Connect API. To learn more, see . After you create your request, use 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](/documentation/Analytics-Reports/data-completeness-corrections). > Note: For weekly and monthly report instances, the `Date` column represents the first day of the week and month, respectively. ### 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](https://developer.apple.com/documentation/appstoreconnectapi/post-v1-analyticsreportrequests) 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 [Data Completeness and Corrections](/documentation/Analytics-Reports/data-completeness-corrections) Understand how the Analytics Reports API provides complete data sets. [Protecting user privacy in report data](/documentation/Analytics-Reports/privacy) Understand measures that help protect user privacy. ### App Store Engagement Engagement information shows how people find, discover, and share your app on the App Store. [App Store Discovery and Engagement](/documentation/Analytics-Reports/app-store-discovery-and-engagement) Analyze how users interact with your app on the App Store. [App Store Web Preview](/documentation/Analytics-Reports/app-store-web-preview) Analyze how people engage with your app’s product pages and in-app events on web browsers. [App Store Retention Messaging](/documentation/Analytics-Reports/app-store-retention-messaging) Analyze how users interact with retention messages during the subscription cancellation flow. ### App Store Commerce Information about App Store downloads, pre-orders, and purchases. [App Store Downloads](/documentation/Analytics-Reports/app-download) Analyze how many times people download your app on the App Store. [App Store Pre-orders](/documentation/Analytics-Reports/app-store-pre-order) Analyze details on the number of pre-orders that people place and cancel for your app on the App Store. [App Store Purchases](/documentation/Analytics-Reports/app-store-purchase) Analyze total revenue generated by your apps on the App Store. [App Store Subscription State](/documentation/Analytics-Reports/subscription-state) Analyze your App Store subscription performance. [App Store Subscription Event](/documentation/Analytics-Reports/subscription-event) Analyze and track changes throughout your users’ subscription lifecycle. ### App Usage Usage information helps you understand how people interact with your apps, and includes details about app sessions, installations, and crashes. [App Clip Usage](/documentation/Analytics-Reports/app-clip-usage) Analyze how users engage with your App Clips. [App Crashes](/documentation/Analytics-Reports/app-crashes) Review crashes for your App Store apps based on app version and device type. [App Store Installations and Deletions](/documentation/Analytics-Reports/app-installs) Analyze details on the number of times users install and delete your apps. [App Store Opt-in](/documentation/Analytics-Reports/app-store-opt-in) Analyze the percentage of first-time app downloaders who choose to share their data with you. [App Sessions](/documentation/Analytics-Reports/app-sessions) Analyze how often people open your App Store apps, and the average session duration. [CarPlay App Usage](/documentation/Analytics-Reports/carplay-app-usage) Review how people use CarPlay in your app. [Platform App Installs](/documentation/Analytics-Reports/platform-app-installs) Analyze your app’s install data by date, install type, channel, device, platform version, and territory. [Shortcut App Usage](/documentation/Analytics-Reports/shortcut-app-usage) Analyze how often people use a shortcut action in your app. [Shortcuts Actions Usage](/documentation/Analytics-Reports/shortcuts-actions-usage) Analyze how often people run shortcuts with your app’s actions. ### Framework Usage Framework usage details help you analyze how people interact with your app and how your app uses APIs. [AccessorySetupKit Accessory Picker Sessions](/documentation/Analytics-Reports/accessorysetupkit-accessory-picker-sessions) Analyze how many people use your app to set up accessories by using AccessorySetupKit. [AccessorySetupKit Usage](/documentation/Analytics-Reports/accessorysetupkit-usage) Analyze how often your app uses AccessorySetupKit. [AirPlay Discovery Sessions](/documentation/Analytics-Reports/airplay-discovery-sessions) Review information about AirPlay discovery sessions. [Animoji Stickers Sent](/documentation/Analytics-Reports/animoji-stickers-sent) Analyze how many times people use Memoji stickers in your app. [App Added to Focus](/documentation/Analytics-Reports/app-added-to-focus) Review information about your app’s relationship to Focus modes. [App Disk Space Usage](/documentation/Analytics-Reports/app-disk-space-usage) Analyze your app’s disk space use. [App Extended Launch Usage](/documentation/Analytics-Reports/app-extended-launch-usage) Understand your app’s use of extended launch. [App HangTracer Usage](/documentation/Analytics-Reports/app-hangtracer-usage) Analyze how much time your app spends monitoring foreground UI responsiveness through the HangTracer Framework. [App Runtime Usage](/documentation/Analytics-Reports/app-runtime-usage) Analyze how often your app executes specific symbols of different dynamic libraries. [App Sessions Context](/documentation/Analytics-Reports/app-sessions-context) Analyze how many people use your app and for how long. [Application Preferred Language Settings](/documentation/Analytics-Reports/application-preferred-language-settings) Review how people use language preference settings in your app. [ARKit ARSession Duration](/documentation/Analytics-Reports/arkit-arsession-duration) Review information about ARKit ARSession duration. [ARKit ARSession Failures](/documentation/Analytics-Reports/arkit-arsession-failures) Analyze details about ARKit ARSession failures. [ARKit Capture Frame Rate Throttling](/documentation/Analytics-Reports/arkit-capture-frame-rate-throttling) Analyze how long it takes for ARKit to throttle the camera frame rate. [ARKit Collaborative Session Features](/documentation/Analytics-Reports/arkit-collaborative-session-features) Review how your app uses ARKit collaborative session features. [ARKit Face Tracking](/documentation/Analytics-Reports/arkit-face-tracking) Analyze how often your app uses ARKit face tracking. [ARKit Video Formats](/documentation/Analytics-Reports/arkit-video-formats) Review information about ARKit video formats and high-resolution frames. [ARKit World Tracking](/documentation/Analytics-Reports/arkit-world-tracking) Review the configured settings for world tracking in your app. [ARKit World Tracking Image Detection](/documentation/Analytics-Reports/arkit-world-tracking-image-detection) Analyze the number of images detected in ARKit world tracking. [Audio Input Muting](/documentation/Analytics-Reports/audio-input-muting) Analyze details about audio-input muting and unmuting gestures during a call with conferencing apps. [Audio Input Route and Duration and Call Mode](/documentation/Analytics-Reports/audio-input-route-and-duration-and-call-mode) Review how your app uses audio session inputs. [Audio Session Audio Unit Usage](/documentation/Analytics-Reports/audio-session-audio-unit-usage) Analyze your app’s audio unit use. [Audio Volume Levels and Duration](/documentation/Analytics-Reports/audio-volume-levels-and-duration) Review how your app uses volume and duration for output audio. [Automatic Speech Recognition Usage](/documentation/Analytics-Reports/automatic-speech-recognition-usage) Analyze how often people use dictation or Siri in your app. [Bluetooth LE Advertising](/documentation/Analytics-Reports/bluetooth-le-advertising) Review how your app uses Bluetooth Low Energy (LE) advertising. [Bluetooth LE Connection Results](/documentation/Analytics-Reports/bluetooth-le-connection-results) Analyze how often your app uses Low Energy (LE) connections and the connection results. [Bluetooth LE Connections Per App](/documentation/Analytics-Reports/bluetooth-le-connections-per-app) Analyze the number of completed Bluetooth Low Energy (LE) connections for your app. [Bluetooth LE Disconnection Results](/documentation/Analytics-Reports/bluetooth-le-disconnection-results) Review Low Energy (LE) disconnections for your app. [Bluetooth LE Scans](/documentation/Analytics-Reports/bluetooth-le-scans) Review how your app uses Bluetooth Low Energy (LE) scans. [Bluetooth LE Sessions](/documentation/Analytics-Reports/bluetooth-le-sessions) Analyze how often your app uses Bluetooth Low Energy (LE) connections. [Browser Choice Screen Engagement (iOS versions before 18.2)](/documentation/Analytics-Reports/browser-choice-screen-engagement) Measure how often your web browser app is being selected as the default from the browser choice screen on iOS. [Browser Choice Screen Selection](/documentation/Analytics-Reports/browser-choice-screen-selection) This report details percentage of devices that had your web browser application selected as default from the Browser Choice screen. [Call Services and Call Performance](/documentation/Analytics-Reports/call-services-and-call-performance) Review your app’s use of call services and call performance. [CarPlay Navigation](/documentation/Analytics-Reports/carplay-navigation) Analyze how often people start route-guidance sessions in your app. [Collaboration Message Usage](/documentation/Analytics-Reports/collaboration-message-usage) Analyze how often people use collaboration messages in your app. [Core Location Authorization Results](/documentation/Analytics-Reports/core-location-authorization-results) Review authorizations that people grant as a result of requests from your app. [Core Location Geofencing](/documentation/Analytics-Reports/core-location-geofencing) Review how your app uses geo fences. [CRABS-Based Video Playback Usage](/documentation/Analytics-Reports/crabs-based-video-playback-usage) Analyze how often your app uses CRABS video playback or video playback that uses the CRABS protocol. [Custom Language Model Builds Started](/documentation/Analytics-Reports/custom-language-model-builds-started) Analyze how often your app triggers a rebuild of custom language models. [Customized Transcription Requests](/documentation/Analytics-Reports/customized-transcription-requests) Analyze transcription request use of custom language models. [Default Browser Usage Rate](/documentation/Analytics-Reports/default-browser-usage-rate) Review percentage of devices where your browser app is set as the default web browser. [DockKit App Usage](/documentation/Analytics-Reports/dockkit-app-usage) Review how your application uses DockKit accessories. [Dynamic Island Layout Changes](/documentation/Analytics-Reports/dynamic-island-layout-changes) Analyze changes in Dynamic Island layout state. [Face-Driven Auto Exposure and Auto Focus Usage](/documentation/Analytics-Reports/face-driven-auto-exposure-and-auto-focus-usage) Analyze how people use face-driven auto exposure (AE) and auto focus (AF) in your app. [File-Based Video Playback Usage](/documentation/Analytics-Reports/file-based-video-playback-usage) Analyze how often your app uses file playback or playback that occurs on the local file system. [File-System Events API Usage](/documentation/Analytics-Reports/file-system-events-api-usage) Analyze how many file-system events resources your app uses. [Flashlight Usage](/documentation/Analytics-Reports/flashlight-usage) Review information about flashlight state. [Game Controller Haptics Engine Creation](/documentation/Analytics-Reports/game-controller-haptics-engine-creation) Analyze how your app uses haptic localities and which controllers it uses. [Game Controller Sessions](/documentation/Analytics-Reports/game-controller-sessions) Analyze how often and how long people are in game-controller sessions in your app. [Haptics Engine Usage](/documentation/Analytics-Reports/haptics-engine-usage) Review how often your app plays haptics. [Home Screen Widget Installs](/documentation/Analytics-Reports/home-screen-widget-installs) Analyze how often people add your widget to their Home Screens. [Home Screen Widget Rotations](/documentation/Analytics-Reports/home-screen-widget-rotations) Analyze how often your app’s widget rotates to the front of a Smart Stack. [Home Screen Widget Usage](/documentation/Analytics-Reports/home-screen-widget-usage) Analyze how many people are interacting with your Widget. [Home Screen Widgets](/documentation/Analytics-Reports/home-screen-widgets) Analyze when the system adds your app widget to a default Smart Stack on the Home Screen. [HTTP Live Streaming Playback Count](/documentation/Analytics-Reports/http-live-streaming-playback-count) Review your app’s use of HTTP Live Streaming (HLS) assets in AVFoundation APIs. [HTTP Live Streaming Video Playback Usage](/documentation/Analytics-Reports/http-live-streaming-video-playback-usage) Review information about how your app uses HTTP live streaming (HLS) video playback or video playback that uses the HLS protocol. [iBeacon Add Region Usage](/documentation/Analytics-Reports/ibeacon-add-region-usage) Analyze how your app uses the iBeacon Add Region API. [iBeacon Ranging Usage](/documentation/Analytics-Reports/ibeacon-ranging-usage) Review information about how your app uses the iBeacon Ranging API. [iBeacon Stop Monitoring for Region Usage](/documentation/Analytics-Reports/ibeacon-stop-monitoring-for-region-usage) Analyze how frequently your app uses the iBeacon Stop Monitoring for Region API. [Keyboard Dictation Usage](/documentation/Analytics-Reports/keyboard-dictation-usage) Analyze how people use keyboard dictation in your app. [Live Activity Use](/documentation/Analytics-Reports/live-activity-use) Review how your app uses Live Activity. [Load CoreML Models Metrics](/documentation/Analytics-Reports/load-coreml-models-metrics) Review your app’s use of Core ML models. [Local Network Privacy](/documentation/Analytics-Reports/local-network-privacy) Analyze results of the Local Network Privacy prompt. [Location Sessions](/documentation/Analytics-Reports/location-sessions) Review how your app uses Core Location APIs. [Lock Screen Widget Configuration](/documentation/Analytics-Reports/lock-screen-widget-configuration) Analyze how often people configure your widgets on the Lock Screen. [Metal Command Queues](/documentation/Analytics-Reports/metal-command-queues) Review your app’s use of Metal Command Queues. [Mode Activity Notifications](/documentation/Analytics-Reports/mode-activity-notifications) Review information about how users resolve notifications in your app. [Multiple Game Controllers Usage](/documentation/Analytics-Reports/multiple-game-controllers-usage) Review how people using your app use multiple game controllers. [Nearby Interaction Sessions](/documentation/Analytics-Reports/nearby-interaction-sessions) Analyze how often your app starts an Ultra Wideband (UWB) ranging session through Nearby Interaction. [Notification Summary Engagement](/documentation/Analytics-Reports/notification-summary-engagement) Analyze how often people engage with notification summaries in your app. [Photo Capture Usage](/documentation/Analytics-Reports/photo-capture-usage) Analyze how your app uses Photo capture in photos. [Photogrammetry ObjectCaptureSession API Usage](/documentation/Analytics-Reports/photogrammetry-objectcapturesession-api-usage) Review how often your app uses object capture for photogrammetry. [PhotogrammetrySession API Usage](/documentation/Analytics-Reports/photogrammetrysession-api-usage) Review how often your app uses object modeling for photogrammetry. [PhotoKit Imports](/documentation/Analytics-Reports/photokit-imports) Review how your app imports PhotoKit assets. [Photos Library Access](/documentation/Analytics-Reports/photos-library-access) Review what type of Photos Library Access people grant in your app. [Photos Picker](/documentation/Analytics-Reports/photos-picker) Analyze how people use Photos in your app. [Photos Sharing](/documentation/Analytics-Reports/photos-sharing) Analyze how often people share Photos in your app. [ProRes Video Usage](/documentation/Analytics-Reports/prores-video-usage) Review how people use ProRes videos in your app. [Reminders Usage](/documentation/Analytics-Reports/reminders-usage) Analyze how often your app interacts with system reminders. [RoomPlan Usage](/documentation/Analytics-Reports/roomplan-usage) Review how people use RoomPlan in your app. [Safari Extensions Enablement](/documentation/Analytics-Reports/safari-extensions-enablement) Analyze how often people enable your Safari extension. [Safari Extensions Usage](/documentation/Analytics-Reports/safari-extensions-usage) Review how people use your Safari extension. [Shared With You Content Engagement](/documentation/Analytics-Reports/shared-with-you-content-engagement) Review information about people engaging with Shared with You content in your app. [SharePlay Usage by Activity Type](/documentation/Analytics-Reports/shareplay-usage-by-activity-type) Review how people use SharePlay in your app. [ShazamKit Usage](/documentation/Analytics-Reports/shazamkit-usage) Analyze how your app utilizes ShazamKit. [Spatial Audio Usage](/documentation/Analytics-Reports/spatial-audio-usage) Analyze changes in spatial audio modes. [Speech Framework Transcription Request Audio Duration](/documentation/Analytics-Reports/speech-framework-transcription-request-audio-duration) Analyze the distribution of audio duration for transcription requests in your app. [Speech Framework Transcription Requests](/documentation/Analytics-Reports/speech-framework-transcription-requests) Review transcription requests in your app. [Text-Input Actions](/documentation/Analytics-Reports/text-input-actions) Review information on text-input actions. [Translation Request Usage](/documentation/Analytics-Reports/translation-request-usage) Review information about how people use speech-to-text translation in your app. [Verify With Wallet Document Request Availability](/documentation/Analytics-Reports/verify-with-wallet-document-request-availability) Review how your app uses identity and authorization APIs to check document request availability [Verify with Wallet Document Requests](/documentation/Analytics-Reports/verify-with-wallet-document-requests) Review how your app uses identity and authorization APIs. [Video Duration Information](/documentation/Analytics-Reports/video-duration-information) Review information about video duration. [Video PiP Duration](/documentation/Analytics-Reports/video-pip-duration) Review the duration of time your app uses Picture in Picture (PiP). [Video Streaming Duration](/documentation/Analytics-Reports/video-streaming-duration) Review how people use video streaming in your app. [VisionKit Data Detectors](/documentation/Analytics-Reports/visionkit-data-detectors) Review your app’s use of data detector invocation for VisionKit. [VisionKit Image Analysis](/documentation/Analytics-Reports/visionkit-image-analysis) Analyze VisionKit analysis requests on images. [VisionKit Live Text Usage](/documentation/Analytics-Reports/visionkit-live-text-usage) Review information about how people interact with Live Text. [VisionKit Sessions](/documentation/Analytics-Reports/visionkit-sessions) Review VisionKit sessions in your app. [Wi-Fi Known Network Modifications](/documentation/Analytics-Reports/wi-fi-known-network-modifications) Analyze details about people adding and removing known networks by using Wi-Fi manager in your app. ### Performance Performance metrics show how your app performs and how users interact with specific features. [AirPlay Errors](/documentation/Analytics-Reports/airplay-errors) Analyze AirPlay errors in your apps. [AirPlay Performance](/documentation/Analytics-Reports/airplay-performance) Review AirPlay performance in your apps. [App Crashes Expanded](/documentation/Analytics-Reports/app-crashes-expanded) Analyze the rate at which your app crashes. [App Installs Performance](/documentation/Analytics-Reports/app-installs-performance) Analyze details about installation success and failure rates for your apps. [App Neural Footprint](/documentation/Analytics-Reports/app-neural-footprint) Analyze how much memory your process induces the Apple Neural Engine to wire down on your process’s behalf. [App Storage Reads and Writes](/documentation/Analytics-Reports/app-storage-reads-and-writes) Analyze how often your app uses disk reads and writes. [Audio Overloads](/documentation/Analytics-Reports/audio-overloads) Analyze how many audio glitches people experience in your app. [Bluetooth LE Session Duration](/documentation/Analytics-Reports/bluetooth-le-session-duration) Analyze how long your app uses Bluetooth Low Energy (LE) connections. [Bluetooth System Wakes](/documentation/Analytics-Reports/bluetooth-system-wakes) Analyze details about bluetooth system wakes that your app causes. [CAMetalLayer Performance](/documentation/Analytics-Reports/cametallayer-performance) Review CAMetalLayer metadata and performance in your app. [Cellular Plan Provisioning](/documentation/Analytics-Reports/cellular-plan-provisioning) Analyze how often people use your app for eSim install and the success rate. [Custom Language Model Builds Failed](/documentation/Analytics-Reports/custom-language-model-builds-failed) Analyze how often your app-triggered rebuild of a custom language model failed. [Display Power Information](/documentation/Analytics-Reports/display-power-information) Review your app’s impact on display pixel attributes. [Embedding Generation](/documentation/Analytics-Reports/embedding-generation) Analyze details about embedding generation throughput in your app. [HTTP Live Streaming Playback Errors](/documentation/Analytics-Reports/http-live-streaming-playback-errors) Analyze playback errors that your app receives. [Launch Image Over Memory Limit](/documentation/Analytics-Reports/launch-image-over-memory-limit) Analyze how often your app fails to load because it’s over the memory limit. [Media Device Extension Errors](/documentation/Analytics-Reports/media-device-extension-errors) Analyze Media Device Extension errors in your apps. [Media Device Extension Performance](/documentation/Analytics-Reports/media-device-extension-performance) Review Media Device Extension performance in your apps. [Networking Connection Activity](/documentation/Analytics-Reports/networking-connection-activity) Review how your app uses network connections. [Spotlight Query Performance](/documentation/Analytics-Reports/spotlight-query-performance) Review how your app uses Spotlight queries. [Streaming Downloads Performance](/documentation/Analytics-Reports/streaming-downloads-performance) Review download performance when using the AVAssetDownloadTask APIs in your apps. [Streaming Playback Performance](/documentation/Analytics-Reports/streaming-playback-performance) Review playback performance when using the AVPlayerItem APIs in your apps. --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)