App Store Connect Help
App Store Connect/Reference/Reporting/Subscription Report
Subscription Report
The below table shows columns forSubscription Report Version 1_3.
Tip:To better understand the values below, view asample report.
Report Field | Data Type | Notes |
|---|---|---|
App Name | String | Title of your subscription’s parent app. |
AppApple ID | BigInt | Apple ID of your subscription’s parent app. |
Subscription Name | String | Title of your subscription. |
Subscription Apple ID | BigInt | Apple ID of your subscription. |
Subscription Group ID | BigInt | Your subscription’s Group ID (formerly Family ID). |
Standard Subscription Duration | Int | Duration of the standard subscription: 7 Days, 1 Month, 2 Months, 3 Months, 6 Months, or 1 Year. |
Subscription Offer Name | String | Offer reference name that you set for your subscription offers in App Store Connect. |
Promotional Offer ID | String | An identifier that you set for your subscription offers in App Store Connect. |
Customer Price | Decimal | Retail Price displayed on the App Store and charged to the customer. |
Customer Currency | String | Three-character ISO code indicating the customer’s currency. For more information, visitCurrency codes. |
Developer Proceeds | Decimal | The proceeds for each subscription. |
Proceeds Currency | String | The currency in which your proceeds are earned. For more information, visitCurrency codes. |
Preserved Pricing | String | For Renew events, if the price is preserved then this field equals “Yes”. Otherwise, it is blank. |
Proceeds Reason | String | For Renew events, if the subscription has been active for more than a year then you receive 85% of the customer price, minus applicable taxes, and this field equals “Rate After One Year”. Otherwise, you receive 70% and the field is blank. |
Client | String | If the subscription was purchased from News then this field equals “News”. Otherwise, it is blank. |
Device | String | Type of device used for subscription purchase: iPhone, iPad, iPod touch, Desktop, Apple TV, or Apple Vision. |
State | String | State field in the address submitted by the customer when signing up for their Apple Account. This field is not validated and may be blank. |
Country | String | Two-character ISO country code indicating the App Store country or region for the purchase. For more information, visitFinancial report regions and currencies. |
Active Standard Price Subscriptions | Int | Total number of auto-renewable standard paid subscriptions currently active, excluding free trials, subscription offers, introductory offers, and marketing opt-ins. Subscriptions are active during the period for which the customer has paid without cancellation. |
Active Free Trial Introductory Offer Subscriptions | Int | Total number of introductory offer subscriptions currently in a free trial. |
Active Pay Up Front Introductory Offer Subscriptions | Int | Total number of introductory offer subscriptions currently with a pay up front introductory price. |
Active Pay as You Go Introductory Offer Subscriptions | Int | Total number of introductory offer subscriptions currently with a pay as you go introductory price. |
Free Trial Promotional Offer Subscriptions | Int | Total number of promotional offers currently in a free trial. |
Pay Up Front Promotional Offer Subscriptions | Int | Total number of promotional offers with a pay up front promotional price. |
Pay As You Go Promotional Offer Subscriptions | Int | Total number of promotional offers with a pay as you go promotional price. |
Free Trial Offer Code Subscriptions | Int | Total number of offer code subscriptions currently in a free trial. |
Pay Up Front Offer Code Subscriptions | Int | Total number of offer code subscriptions with a pay up front offer price. |
Pay As You Go Offer Code Subscriptions | Int | Total number of offer code subscriptions with a pay as you go offer price. |
Marketing Opt-Ins | Int | Total number of subscriptions currently in a marketing opt-in bonus period. |
Billing Retry | Int | Total number of subscriptions in the Billing Retry status. This indicates that the App Store is still attempting to automatically renew a subscription when billing issues arise (for example, an expired credit card). Available in reports for dates starting December 7, 2017. |
Grace Period | Int | Total number of subscriptions in the Billing Grace Period state. This indicates that subscriber can continue accessing your content for a certain period of time (6 or 16 days) while Apple attempts to correct the billing issue. |
Subscribers | Int | The number of subscribers who have access to the auto-renewable subscription including entitled family members. Note that this field is only populated when the record represents more than 3 subscriptions.Learn more. |
Free Trial Win-Back Offers | Int | Total number of subscriptions on a free trial win-back offer. |
Pay Up Front Win-Back Offers | Int | Total number of subscriptions on a pay up front win-back offer. |
Pay As You Go Win-Back Offers | Int | Total number of subscriptions on a pay as you go win-back offer. |