Contains event-level data about subscription payments such as Activations, Renewals, Refunds, Cancellations an Reactivations.
Fields included in this report
Subscription Offer Duration
Duration of the introductory price if applicable. For example: 3 Days, 7 Days, 2 Weeks, 1 Month, 2 Months, 3 Months, 6 Months, or 1 Year.
Subscription Name
Title of your subscription.
Subscription Offer Type
Type of introductory price: Pay Up Front, Pay As You Go, or Free Trial
Quantity
Number of events with the same values for the other fields.
Subscription Group ID
Your subscription’s Group ID (formerly Family ID).
Subscription Apple ID
Apple ID of your subscription.
State
State field in the address submitted by the customer when signing up for their Apple ID. This field is not validated and may be blank.
Standard Subscription Duration
Duration of the standard subscription: 7 Days, 1 Month, 2 Months, 3 Months, 6 Months, or 1 Year.
Promotional Offer Name
The Promotional Offer Reference Name used in App Store Connect when setting up the offer.
Previous Subscription Apple ID
For upgrade, downgrade, and crossgrade events, the Apple ID of the previous subscription.
Proceeds Reason
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.
Promotional Offer ID
An identifier that you set for your subscription offers in App Store Connect. This is the value entered in the Promotional Offer Product Code field when setting up a subscription offer. For details on implementation, visit Generating a Signature for Promotional Offers.
Previous Subscription Name
For upgrade, downgrade, and crossgrade events, the title of the previous subscription.
Marketing Opt-In Duration
Duration of the opt-in if applicable: 7 Days, 1 Month, 2 Months, 3 Months, 6 Months, or 1 Year.
Preserved Pricing
For Renew events, if the price is preserved then this field equals “Yes”. Otherwise, it is blank.
Paid Service Days Recovered
The estimated number of paid service days recovered due to Billing Grace Period
Original Start Date
Date of the initial subscription purchase.
Event
Type of event that occurred. For more information, visit Subscriptions Events.
Event Date
Date the event occurred.
Marketing Opt-In
If the subscription included a marketing opt-in, this field equals “Yes”. Otherwise, it is blank.
Device
Type of device used for initial subscription purchase: iPhone, iPad, Apple TV, iPod touch, or Desktop.
Days Canceled
For reactivate events, the number of days ago that the subscriber canceled.
Days Before Canceling
For cancel events, the number of days from the start date to when a subscriber canceled, which could be in the middle of the period. This only applies to cancel events where cancellation reason equals ‘canceled.' Otherwise, it is blank.
Consecutive Paid Periods
The total number of paid periods that the subscription has been active without cancellation. This does not include free trials, marketing opt-in bonus periods, or grace periods.
Client
If the subscription was purchased from News then this field equals “News”. Otherwise, it is blank.
App Name
Title of your subscription’s parent app.
App Apple ID
Apple ID of your subscription’s parent app.
Country
Two-character ISO country code indicating the App Store territory for the purchase. For more information, visit Financial Report Regions and Currencies
Cancellation Reason
Reason for a cancellation: Billing issue, Price increase, Canceled, Removed from Sale, or Other. For more information, visit Cancellation reasons.
The App Store was unable to complete the transaction of switching a subscription with an offer code to a subscription within the same level due to a billing issue.
The App Store was unable to complete the transaction of switching a subscription with an offer code to a subscription of a lower level due to a billing issue.
The App Store was unable to complete the transaction of switching a subscription with an offer code to a subscription of a higher level due to a billing issue.
Subscriber opted not to renew your subscription from within their Apple ID account settings. A subscription counts as canceled when the subscription period ends, as opposed to when the subscriber turned off auto-renew which could be in the middle of the period.
Subscriber switched between standard price subscriptions of the same level in the same subscription group. If the subscriptions are of the same duration, the crossgrade is counted when it goes into effect immediately. If the subscriptions are of different durations, the crossgrade is counted when it goes into effect on the subscriber’s next renewal date, as opposed to when the subscriber switches their subscription, which could be in the middle of the period.
When a customer switches between an introductory offer and a standard price subscription within the same level. If the in-app purchases are of the same duration, the customer’s prorated amount from the introductory price is refunded to the original payment method. The new in-app purchase is charged and goes into effect immediately at the full price, which changes the customer’s renewal date to the crossgrade date. If the in-app purchases are of different durations, the crossgrade goes into effect on the customer’s next renewal date.
Subscriber switched from a marketing opt-in bonus period to a standard price subscription within the same level in the same subscription group. The crossgrade goes into effect at the end of the opt-in bonus period.
The App Store successfully completed the transaction within a 6 or 16 Billing Grace Period window, and switched between subscriptions within the same level.
When a customer switches between subscriptions within the same level. If the in-app purchases are of the same duration, the customer’s prorated amount from the introductory offer is refunded to the original payment method. The new in-app purchase is charged and goes into effect immediately at the full price, which changes the customer’s renewal date to the crossgrade date. If the in-app purchases are of different durations, the crossgrade goes into effect on the customer’s next renewal date.
Subscriber switched from a standard price subscription in a higher level to a subscription in a lower level in the same subscription group. A subscription counts as downgraded when it goes into effect on the subscriber’s next renewal date, as opposed to when the subscriber switches their subscription, which could be in the middle of the period.
When a customer switches from an introductory offer in a higher level to a standard price subscription in a lower level. A customer downgrade doesn't take effect immediately. If a customer is in a pay as you go introductory price, they are charged for the downgraded subscription at the next billing cycle in the introductory period. If a customer is in a pay up front introductory price, they are charged for the downgraded subscription after the entire introductory period ends.
The App Store successfully completed the transaction within a 6 or 16 Billing Grace Period window, and switched from a subscription in a higher level to a subscription in a lower level.
When a customer switches from a subscription in a higher level to a subscription in a lower level. A customer downgrade doesn't take effect immediately. If a customer is in a pay as you go introductory price, they are charged for the downgraded subscription at the next billing cycle in the introductory period. If a customer is in a pay up front introductory price, they are charged for the downgraded subscription after the entire introductory period ends.
Subscriber switched from a marketing opt-in bonus period to a standard price subscription in a lower level in the same subscription group. The downgrade goes into effect at the end of the opt-in bonus period.
The App Store was unable to complete the transaction of renewing an introductory offer to a paid subscription due to a billing issue, and the subscription enters a 6 or 16 day Billing Grace Period window.
The App Store was unable to complete the transaction of renewing a subscription with a offer code due to a billing issue, and the subscription enters a 6 or 16 day Billing Grace Period window.
The App Store was unable to complete the transaction of renewing a subscription with a marketing opt-in bonus period due to a billing issue and the subscription enters a 6 or 16 day Billing Grace Period window.
The App Store was unable to complete the transaction of renewing a standard paid subscription due to a billing issue, and the subscription enters a 6 or 16 day Billing Grace Period window.
The App Store was unable to complete the transaction of renewing a subscription on a promotional offer to a paid subscription due to a billing issue, and the subscription enters a 6 or 16 day Billing Grace Period window.
The App Store successfully completed the transaction within a 6 or 16 Billing Grace Period window, and renewed to an introductory offer of an equal level.
The App Store successfully completed the transaction within a 6 or 16 Billing Grace Period window, and renewed to an introductory offer of a lower level.
The App Store successfully completed the transaction within a 6 or 16 Billing Grace Period window, and renewed to an introductory offer of a higher level.
Subscriber signed up for an introductory offer of an equal level after previously being subscribed to a subscription offer of a different subscription group.
Subscriber signed up for an introductory offer of a lower level after previously being subscribed to a subscription offer of a different subscription group.
Subscriber signed up for an introductory offer of a higher level after previously being subscribed to a subscription offer of a different subscription group.
The App Store successfully completed the transaction within a 6 or 16 Billing Grace Period window, and renewed to a subscription of an equal level with an offer code.
The App Store successfully completed the transaction within a 6 or 16 Billing Grace Period window, and renewed to a subscription of a lower level with an offer code.
The App Store successfully completed the transaction within a 6 or 16 Billing Grace Period window, and renewed to a subscription of a higher level with an offer code.
Subscriber switched from a marketing opt-in bonus period to a paid subscription in a higher level in the same subscription group. The upgrade goes into effect at the end of the opt-in bonus period.
The App Store successfully completed the transaction within a 6 or 16 Billing Grace Period window, and renewed to a subscription of an equal level with a promotional offer.
The App Store successfully completed the transaction within a 6 or 16 Billing Grace Period window, and renewed to a subscription of a lower level with a promotional offer.
The App Store successfully completed the transaction within a 6 or 16 Billing Grace Period window, and renewed to a subscription of a higher level with a promotional offer.
