--- title: Analytics Reports framework: analytics-reports role: collection path: analytics-reports --- # Analytics Reports A list of app development reports, their field descriptions, and glossaries. ## Overview 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 note: 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 Download Sales and Trends Reports but can’t access Download Finance Reports endpoint. 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. 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 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](analytics-reports/data-completeness-corrections.md) - [Protecting user privacy in report data](analytics-reports/privacy.md) ### App Store Engagement - [App Store Discovery and Engagement](analytics-reports/app-store-discovery-and-engagement.md) - [App Store Web Preview](analytics-reports/app-store-web-preview.md) - [App Store Retention Messaging](analytics-reports/app-store-retention-messaging.md) ### App Store Commerce - [App Store Downloads](analytics-reports/app-download.md) - [App Store Pre-orders](analytics-reports/app-store-pre-order.md) - [App Store Purchases](analytics-reports/app-store-purchase.md) - [App Store Subscription State](analytics-reports/subscription-state.md) - [App Store Subscription Event](analytics-reports/subscription-event.md) ### App Usage - [App Clip Usage](analytics-reports/app-clip-usage.md) - [App Crashes](analytics-reports/app-crashes.md) - [App Store Installations and Deletions](analytics-reports/app-installs.md) - [App Store Opt-in](analytics-reports/app-store-opt-in.md) - [App Sessions](analytics-reports/app-sessions.md) - [CarPlay App Usage](analytics-reports/carplay-app-usage.md) - [Platform App Installs](analytics-reports/platform-app-installs.md) - [Shortcut App Usage](analytics-reports/shortcut-app-usage.md) - [Shortcuts Actions Usage](analytics-reports/shortcuts-actions-usage.md) ### Framework Usage - [AccessorySetupKit Accessory Picker Sessions](analytics-reports/accessorysetupkit-accessory-picker-sessions.md) - [AccessorySetupKit Usage](analytics-reports/accessorysetupkit-usage.md) - [AirPlay Discovery Sessions](analytics-reports/airplay-discovery-sessions.md) - [Animoji Stickers Sent](analytics-reports/animoji-stickers-sent.md) - [App Added to Focus](analytics-reports/app-added-to-focus.md) - [App Disk Space Usage](analytics-reports/app-disk-space-usage.md) - [App Extended Launch Usage](analytics-reports/app-extended-launch-usage.md) - [App HangTracer Usage](analytics-reports/app-hangtracer-usage.md) - [App Runtime Usage](analytics-reports/app-runtime-usage.md) - [App Sessions Context](analytics-reports/app-sessions-context.md) - [Application Preferred Language Settings](analytics-reports/application-preferred-language-settings.md) - [ARKit ARSession Duration](analytics-reports/arkit-arsession-duration.md) - [ARKit ARSession Failures](analytics-reports/arkit-arsession-failures.md) - [ARKit Capture Frame Rate Throttling](analytics-reports/arkit-capture-frame-rate-throttling.md) - [ARKit Collaborative Session Features](analytics-reports/arkit-collaborative-session-features.md) - [ARKit Face Tracking](analytics-reports/arkit-face-tracking.md) - [ARKit Video Formats](analytics-reports/arkit-video-formats.md) - [ARKit World Tracking](analytics-reports/arkit-world-tracking.md) - [ARKit World Tracking Image Detection](analytics-reports/arkit-world-tracking-image-detection.md) - [Audio Input Muting](analytics-reports/audio-input-muting.md) - [Audio Input Route and Duration and Call Mode](analytics-reports/audio-input-route-and-duration-and-call-mode.md) - [Audio Session Audio Unit Usage](analytics-reports/audio-session-audio-unit-usage.md) - [Audio Volume Levels and Duration](analytics-reports/audio-volume-levels-and-duration.md) - [Automatic Speech Recognition Usage](analytics-reports/automatic-speech-recognition-usage.md) - [Bluetooth LE Advertising](analytics-reports/bluetooth-le-advertising.md) - [Bluetooth LE Connection Results](analytics-reports/bluetooth-le-connection-results.md) - [Bluetooth LE Connections Per App](analytics-reports/bluetooth-le-connections-per-app.md) - [Bluetooth LE Disconnection Results](analytics-reports/bluetooth-le-disconnection-results.md) - [Bluetooth LE Scans](analytics-reports/bluetooth-le-scans.md) - [Bluetooth LE Sessions](analytics-reports/bluetooth-le-sessions.md) - [Browser Choice Screen Engagement (iOS versions before 18.2)](analytics-reports/browser-choice-screen-engagement.md) - [Browser Choice Screen Selection](analytics-reports/browser-choice-screen-selection.md) - [Call Services and Call Performance](analytics-reports/call-services-and-call-performance.md) - [CarPlay Navigation](analytics-reports/carplay-navigation.md) - [Collaboration Message Usage](analytics-reports/collaboration-message-usage.md) - [Core Location Authorization Results](analytics-reports/core-location-authorization-results.md) - [Core Location Geofencing](analytics-reports/core-location-geofencing.md) - [CRABS-Based Video Playback Usage](analytics-reports/crabs-based-video-playback-usage.md) - [Custom Language Model Builds Started](analytics-reports/custom-language-model-builds-started.md) - [Customized Transcription Requests](analytics-reports/customized-transcription-requests.md) - [Default Browser Usage Rate](analytics-reports/default-browser-usage-rate.md) - [DockKit App Usage](analytics-reports/dockkit-app-usage.md) - [Dynamic Island Layout Changes](analytics-reports/dynamic-island-layout-changes.md) - [Face-Driven Auto Exposure and Auto Focus Usage](analytics-reports/face-driven-auto-exposure-and-auto-focus-usage.md) - [File-Based Video Playback Usage](analytics-reports/file-based-video-playback-usage.md) - [File-System Events API Usage](analytics-reports/file-system-events-api-usage.md) - [Flashlight Usage](analytics-reports/flashlight-usage.md) - [Game Controller Haptics Engine Creation](analytics-reports/game-controller-haptics-engine-creation.md) - [Game Controller Sessions](analytics-reports/game-controller-sessions.md) - [Haptics Engine Usage](analytics-reports/haptics-engine-usage.md) - [Home Screen Widget Installs](analytics-reports/home-screen-widget-installs.md) - [Home Screen Widget Rotations](analytics-reports/home-screen-widget-rotations.md) - [Home Screen Widget Usage](analytics-reports/home-screen-widget-usage.md) - [Home Screen Widgets](analytics-reports/home-screen-widgets.md) - [HTTP Live Streaming Playback Count](analytics-reports/http-live-streaming-playback-count.md) - [HTTP Live Streaming Video Playback Usage](analytics-reports/http-live-streaming-video-playback-usage.md) - [iBeacon Add Region Usage](analytics-reports/ibeacon-add-region-usage.md) - [iBeacon Ranging Usage](analytics-reports/ibeacon-ranging-usage.md) - [iBeacon Stop Monitoring for Region Usage](analytics-reports/ibeacon-stop-monitoring-for-region-usage.md) - [Keyboard Dictation Usage](analytics-reports/keyboard-dictation-usage.md) - [Live Activity Use](analytics-reports/live-activity-use.md) - [Load CoreML Models Metrics](analytics-reports/load-coreml-models-metrics.md) - [Local Network Privacy](analytics-reports/local-network-privacy.md) - [Location Sessions](analytics-reports/location-sessions.md) - [Lock Screen Widget Configuration](analytics-reports/lock-screen-widget-configuration.md) - [Metal Command Queues](analytics-reports/metal-command-queues.md) - [Mode Activity Notifications](analytics-reports/mode-activity-notifications.md) - [Multiple Game Controllers Usage](analytics-reports/multiple-game-controllers-usage.md) - [Nearby Interaction Sessions](analytics-reports/nearby-interaction-sessions.md) - [Notification Summary Engagement](analytics-reports/notification-summary-engagement.md) - [Photo Capture Usage](analytics-reports/photo-capture-usage.md) - [Photogrammetry ObjectCaptureSession API Usage](analytics-reports/photogrammetry-objectcapturesession-api-usage.md) - [PhotogrammetrySession API Usage](analytics-reports/photogrammetrysession-api-usage.md) - [PhotoKit Imports](analytics-reports/photokit-imports.md) - [Photos Library Access](analytics-reports/photos-library-access.md) - [Photos Picker](analytics-reports/photos-picker.md) - [Photos Sharing](analytics-reports/photos-sharing.md) - [ProRes Video Usage](analytics-reports/prores-video-usage.md) - [Reminders Usage](analytics-reports/reminders-usage.md) - [RoomPlan Usage](analytics-reports/roomplan-usage.md) - [Safari Extensions Enablement](analytics-reports/safari-extensions-enablement.md) - [Safari Extensions Usage](analytics-reports/safari-extensions-usage.md) - [Shared With You Content Engagement](analytics-reports/shared-with-you-content-engagement.md) - [SharePlay Usage by Activity Type](analytics-reports/shareplay-usage-by-activity-type.md) - [ShazamKit Usage](analytics-reports/shazamkit-usage.md) - [Spatial Audio Usage](analytics-reports/spatial-audio-usage.md) - [Speech Framework Transcription Request Audio Duration](analytics-reports/speech-framework-transcription-request-audio-duration.md) - [Speech Framework Transcription Requests](analytics-reports/speech-framework-transcription-requests.md) - [Text-Input Actions](analytics-reports/text-input-actions.md) - [Translation Request Usage](analytics-reports/translation-request-usage.md) - [Verify With Wallet Document Request Availability](analytics-reports/verify-with-wallet-document-request-availability.md) - [Verify with Wallet Document Requests](analytics-reports/verify-with-wallet-document-requests.md) - [Video Duration Information](analytics-reports/video-duration-information.md) - [Video PiP Duration](analytics-reports/video-pip-duration.md) - [Video Streaming Duration](analytics-reports/video-streaming-duration.md) - [VisionKit Data Detectors](analytics-reports/visionkit-data-detectors.md) - [VisionKit Image Analysis](analytics-reports/visionkit-image-analysis.md) - [VisionKit Live Text Usage](analytics-reports/visionkit-live-text-usage.md) - [VisionKit Sessions](analytics-reports/visionkit-sessions.md) - [Wi-Fi Known Network Modifications](analytics-reports/wi-fi-known-network-modifications.md) ### Performance - [AirPlay Errors](analytics-reports/airplay-errors.md) - [AirPlay Performance](analytics-reports/airplay-performance.md) - [App Crashes Expanded](analytics-reports/app-crashes-expanded.md) - [App Installs Performance](analytics-reports/app-installs-performance.md) - [App Neural Footprint](analytics-reports/app-neural-footprint.md) - [App Storage Reads and Writes](analytics-reports/app-storage-reads-and-writes.md) - [Audio Overloads](analytics-reports/audio-overloads.md) - [Bluetooth LE Session Duration](analytics-reports/bluetooth-le-session-duration.md) - [Bluetooth System Wakes](analytics-reports/bluetooth-system-wakes.md) - [CAMetalLayer Performance](analytics-reports/cametallayer-performance.md) - [Cellular Plan Provisioning](analytics-reports/cellular-plan-provisioning.md) - [Custom Language Model Builds Failed](analytics-reports/custom-language-model-builds-failed.md) - [Display Power Information](analytics-reports/display-power-information.md) - [Embedding Generation](analytics-reports/embedding-generation.md) - [HTTP Live Streaming Playback Errors](analytics-reports/http-live-streaming-playback-errors.md) - [Launch Image Over Memory Limit](analytics-reports/launch-image-over-memory-limit.md) - [Media Device Extension Errors](analytics-reports/media-device-extension-errors.md) - [Media Device Extension Performance](analytics-reports/media-device-extension-performance.md) - [Networking Connection Activity](analytics-reports/networking-connection-activity.md) - [Spotlight Query Performance](analytics-reports/spotlight-query-performance.md) - [Streaming Downloads Performance](analytics-reports/streaming-downloads-performance.md) - [Streaming Playback Performance](analytics-reports/streaming-playback-performance.md)