App Store Connect Analytics Help
Filters and Dimensions
Filters and dimensions enable you to view your data by different categories, such as the source of your traffic, user device characteristics, and territory breakdowns. This allows you to dig deeper into your data to identify what might be driving performance.
-
Filters allow you to narrow your view to a specific subset of users or characteristics. For example, you can view downloads from users in the United States, impressions from iPhone devices, or revenue from a particular In-App Purchase. Filters help you focus on what matters most to your business — whether that's a country, platform, campaign, or custom product page.
-
Dimensions allow you to view your data by multiple attributes at the same time, enabling you to pinpoint the factors influencing your results. For example, viewing downloads by territory helps you see your performance for each individual territory at the same time.
Some dimensions are only applicable if certain app features are in use (similar to metrics visibility), and some dimensions only make sense for specific metrics.
You can filter each metric by various dimensions to dig deeper into your data—for example, viewing downloads by territory or narrowing your view to a specific device type. Learn more about the available metrics.
App Store
Available once you have at least five first-time downloads for your app, unless otherwise noted in the Feature adoption column.
|
Term |
Definition |
Feature adoption |
|---|---|---|
|
App Download Date |
The date when the user last downloaded or redownloaded the app from the App Store. Updates and app restores don't impact this date. |
|
|
App Version |
The version of your app displayed on the App Store. This option is only available for Usage metrics. |
Apps and App Clips |
|
Device |
iPhone iPad Apple TV iPod Desktop Apple Vision App Units, In-App Purchases, and Sales are based on the platform on which the app is downloaded from the App Store. Active in Last 30 Days, Product Page Views, Retention, and Sessions are based on the platform on which the app is used. Note: iOS compatible apps can be purchased through iTunes on older devices. |
Apps and App Clips |
|
Platform Version |
The OS version on which the app was downloaded from the App Store or used. App Units, In-App Purchases, and Sales are based on the version on which the app is downloaded. Active in Last 30 Days, Product Page Views, Retention, and Sessions are based on the iOS version on which the app is used. |
Apps and App Clips |
|
Product Page |
Use this filter to view app metrics by a default or custom product page. |
Custom Product Pages |
|
Page Type |
Available Page Types include:
|
|
|
In-App Event |
The In-App Event card or detail page from which a user downloaded or redownloaded your app from the App Store. |
In-App Events |
|
Region |
The App Store region in which purchases were made, based on the customer's billing address. Regions include:
|
Apps and App Clips |
|
Territory |
The App Store territory as determined by the customer's billing address. |
Apps and App Clips |
|
Source Type |
The source type from which a customer tapped a link to your App Store product page to view your app or download it for the first time. Use this filter to view metrics based on the source from which users are finding your app. |
Apps and App Clips |
|
App Referrer |
The app from which a customer tapped a link to your App Store product page to view it or download it for the first time. Filter by App Referrer to view a list of apps that referred users to your app's product page. |
Apps and App Clips |
|
Web Referrer |
The website from which a customer tapped a link to your App Store product page to view it or download it for the first time. Filter by Web Referrer to view a list of websites that referred users to your app's product page. |
Apps and App Clips |
|
Campaign |
Custom App Store links you can use in your marketing materials, websites, or advertising. Campaign links allow you to view your app sales, usage, and monetization for specific campaigns. Campaigns only display in Analytics after more than a day has passed since campaign launch and at least five App Units are attributed to the campaign. |
Campaigns |
|
Pre Orders |
Filtering by Pre-Order allows you to view your sales, usage, and select download and App Store metrics that originated from a pre-order versus standard app downloads. |
Pre-Orders |
Sales
Available for apps with In-App Purchases, subscriptions, and paid apps.
|
Term |
Definition |
|---|---|
|
Purchases |
The app or In-App Purchase, by name or Apple ID. View or filter Sales data by Purchases to locate data for your app or individual In-App Purchases on the App Store. |
|
Purchase Type |
The type of purchase, including Consumable, Non-Consumable, Non-Renewing Subscription, or Auto-Renewable Subscription. |
|
Refund Type |
The type of refund, including Full, Partial, or Complete My Bundle. |
Subscriptions
Available once your app has sold at least one subscription. Some dimensions are only enabled once you adopt additional features, for example the offer name, family sharing, and duration dimensions.
|
Dimension |
Definition |
Applicable to |
Sample Values |
|---|---|---|---|
|
Subscription Group Name |
The group that the subscription belongs to, as set by you in App Store Connect. |
State and Event Metrics |
Premium Access, Basic Access |
|
Subscription Group ID |
The unique identifier assigned to the subscription group by Apple. |
State and Event Metrics |
|
|
Subscription Name |
The name of the subscription that the user has subscribed to, as set by you in App Store Connect. |
State and Event Metrics |
Premium Access, Basic Monthly, Monthly Annual |
|
Subscription Adam ID |
The unique identifier assigned to the subscription by Apple. |
State and Event Metrics |
|
|
Subscription Duration |
The duration of the subscription that the user has subscribed to. |
State and Event Metrics |
1 week, 1 month, 2 months, 3 months, 6 months, 1 year |
|
Subscription Pricing |
The pricing mechanism associated with the paid subscription. |
State and Event Metrics |
Full Price, Preserved Price, Contingent Price |
|
Offer Type |
Type of subscription offer the user has redeemed. |
State and Event Metrics |
Introductory Offer, Offer Code, Promotional Offer, Winback Offer |
|
Offer Pricing |
The pricing mechanism associated with the offer redeemed by the user. |
State and Event Metrics |
Free Trial, Pay As You Go, Pay Up Front |
|
Offer Duration |
The duration of the subscription offer that the user has redeemed. |
State and Event Metrics |
1 week, 1 month, 2 months, 3 months, 6 months, 1 year |
|
Offer Name |
The name of the subscription offer, as set by you in App Store Connect. |
State and Event Metrics |
Spring 2020, Thanksgiving Free Trial Code |
|
Offer ID |
The offer ID of the subscription offer, as set by you in App Store Connect. |
State and Event Metrics |
|
|
Custom Code |
The custom code associated with the offer code, as set by you in App Store Connect. |
State and Event Metrics |
|
|
Initial Offer Start Date |
The date the customer started their initial free trial or paid offer. In the case of a stacked offer, the first offer date is captured. |
State and Event Metrics |
Date picker - supported granularity: day, week, month |
|
Initial Offer Name |
The subscription offer name of the initial subscription offer. |
State and Event Metrics |
Spring 2020, Thanksgiving Free Trial Code |
|
Initial Offer ID |
The offer ID of the initial subscription offer. |
State and Event Metrics |
|
|
Initial Offer Type |
The offer type of the initial subscription offer. |
State and Event Metrics |
Introductory Offer, Offer Code, Promotional Offer, Winback Offer |
|
Initial Offer Pricing |
The offer pricing of the initial subscription offer. |
State and Event Metrics |
Free Trial, Pay As You Go, Pay Up Front |
|
Initial Offer Duration |
Offer duration of the initial subscription offer. |
State and Event Metrics |
1 week, 1 month, 2 months, 3 months, 6 months, 1 year |
|
Paid Subscription Start Date |
The date the customer initially started paying the full price or contingent price. |
State and Event Metrics |
Date picker - supported granularity: day, week, month |
|
Offer Start Date (Last Offer Start Date) |
The date the customer started the most recent free trial or paid offer. |
State and Event Metrics |
Date picker - supported granularity: day, week, month |
|
Last Offer Name |
Subscription offer name of the most recent subscription offer. |
State and Event Metrics |
Spring 2020, Thanksgiving Free Trial Code |
|
Last Offer ID |
Offer ID of the most recent subscription offer. |
State and Event Metrics |
|
|
Last Offer Type |
Type of most recent subscription offer redeemed by the user. |
State and Event Metrics |
Introductory Offer, Offer Code, Promotional Offer, Winback Offer |
|
Last Offer Pricing |
Offer pricing of the most recent subscription offer redeemed by the user. |
State and Event Metrics |
Free Trial, Pay As You Go, Pay Up Front |
|
Last Offer Duration |
Offer duration of the most recent subscription offer redeemed by the user. |
State and Event Metrics |
1 week, 1 month, 2 months, 3 months, 6 months, 1 year |
|
Paid Tenure |
Days of paid service accumulated. Rounded down to the nearest year. |
State and Event Metrics |
<1 year, 1 year, 2 years, 3 years, 4 years, >=5 years |
|
Previous State |
Previous state associated with the subscription. |
Event Metrics |
Free Trial, Paid Offer, Full Price, Preserved Price, Contingent Price, Grace Period, Billing Retry, Voluntary Churn, Involuntary Churn |
|
Current State |
Current state associated with the subscription. |
Event Metrics |
Free Trial, Paid Offer, Full Price, Preserved Price, Contingent Price, Grace Period, Billing Retry, Voluntary Churn, Involuntary Churn |
|
Active State Prior to Billing Issue |
Previous active state prior to billing issue. Applicable only to recovery from billing issue events and involuntary churn events. |
Event Metrics |
Free Trial, Paid Offer, Full Price, Preserved Price, Contingent Price |
|
Previous Subscription Adam ID |
The previous subscription Adam ID the user was subscribed to before they changed plans. |
Event Metrics |
|
|
Previous Subscription Name |
The previous subscription the user was subscribed to before they changed plans. |
Event Metrics |
|
|
Plan Change Type |
Indicates upgrades, crossgrades, and downgrades. |
Event Metrics |
Upgrades, Crossgrades, and Downgrades |
|
Cancellation Reason |
The reason why the subscription was canceled. |
State and Event Metrics |
|
|
Family Sharing |
Indicates whether a user is sharing the subscription with their iCloud family. |
State and Event Metrics |
Individual, Shared with Family |