App Store Connect Help
Subscriber Report
The table shows columns for Subscriber Report version 1_3.
Tip: To better understand the values below, view a sample report.
Report Field |
Data Type |
Notes |
---|---|---|
Event Date |
Date |
Date the event occurred. |
App Name |
String |
Title of your subscription’s parent app. |
App Apple 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 |
String |
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. Note: This isn't available for custom offer codes. |
Subscription Offer Type |
String |
Subscription offer pricing: Pay Up Front, Pay As You Go, or Free Trial. |
Subscription Offer Duration |
String |
Duration of the subscription offer. For example: 3 Days, 7 Days, 2 Weeks, 1 Month, 2 Months, 3 Months, 6 Months, or 1 Year. |
Marketing Opt-In Duration |
String |
Duration of the marketing opt-in if applicable: 7 Days, 1 Month, 2 Months, 3 Months, 6 Months, or 1 Year. |
Customer Price |
Decimal |
The price of your auto-renewable subscription. Negative values indicate refunds. |
Customer Currency |
String |
Three-character ISO code indicating the customer’s currency. For more information, visit Currency codes. |
Developer Proceeds |
Decimal |
The proceeds for each item delivered. |
Proceeds Currency |
String |
The currency in which your proceeds are earned. For more information, visit Currency codes. |
Preserved Pricing |
String |
For renewals, if the price is preserved then this field equals “Yes”. Otherwise, it is blank. |
Proceeds Reason |
String |
If a 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. |
Country |
String |
Two-character ISO country code indicating the App Store country or region for the purchase. For more information, visit Financial report regions and currencies. |
Subscriber ID |
BigInt |
The randomly generated Subscriber ID that's unique to each customer and developer. This field will be null when a customer requests a refund after the 180-day countdown described in Subscriber ID Reset. |
Subscriber ID Reset |
String |
If a customer cancels all of their subscriptions with you and does not resubscribe within 180 days, the Subscriber ID will be deleted. If the same customer resubscribes after 180 days, then we create a new Subscriber ID and this field equals “Yes.” Otherwise, it is blank.Subscriber IDs are reset when an app is transferred to another developer account. |
Refund |
String |
For full or partial refunds, this field equals “Yes.” Otherwise, it's blank. Refunds with a positive customer price imply a refund reversal. |
Purchase Date |
Date |
For refunds, the date of the original purchase. |
Units |
Decimal |
The aggregated number of units. A value of 0 may indicate a partial refund. |