Trends: Subscriptions Events

Apple ID of your subscription’s parent app.

Title of your subscription’s parent app.

Reason for a cancellation: Billing issue, Price increase, Canceled, Removed from Sale, or Other. For more information, visit Cancellation reasons.

If the subscription was purchased from News then this field equals “News”. Otherwise, it is blank.

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.

Two-character ISO country code indicating the App Store territory for the purchase. For more information, visit Financial Report Regions and Currencies

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.

For reactivate events, the number of days ago that the subscriber canceled.

Type of device used for initial subscription purchase: iPhone, iPad, Apple TV, iPod touch, or Desktop.

Type of event that occurred. For more information, visit Subscriptions Events.

Date the event occurred.

If the subscription included a marketing opt-in, this field equals “Yes”. Otherwise, it is blank.

Duration of the opt-in if applicable: 7 Days, 1 Month, 2 Months, 3 Months, 6 Months, or 1 Year.

Date of the initial subscription purchase.

The estimated number of paid service days recovered due to Billing Grace Period

For Renew events, if the price is preserved then this field equals “Yes”. Otherwise, it is blank.

For upgrade, downgrade, and crossgrade events, the Apple ID of the previous subscription.

For upgrade, downgrade, and crossgrade events, the title of the previous subscription.

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.

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.

The Promotional Offer Reference Name used in App Store Connect when setting up the offer.

Number of events with the same values for the other fields.

Duration of the standard subscription: 7 Days, 1 Month, 2 Months, 3 Months, 6 Months, or 1 Year.

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.

Apple ID of your subscription.

Your subscription’s Group ID (formerly Family ID).

Title of your subscription.

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.

Type of introductory price: Pay Up Front, Pay As You Go, or Free Trial

The App Store was unable to complete renewal of a subscription in the billing grace period state due to a billing issue.

The App Store was unable to update a subscription from an introductory price to a standard subscription price due to a billing issue.

The App Store was unable to complete the transaction of renewing a subscription with an offer code 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 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.

The App Store was unable to renew a subscription in a marketing opt-in bonus period due to a billing issue.

The App Store was unable to renew a subscription 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 opted not to renew subscription after a renewal extension.

Subscriber canceled their subscription during Billing Grace Period.

Subscriber canceled their subscription during the 60-day billing retry 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.

The App Store successfully completed the transaction and switched between subscriptions within the same level.

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.

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.

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.

The App Store successfully completed the transaction and switched from a subscription in a higher level to a subscription in a lower level.

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.

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.

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 and renewed to a subscription with an introductory offer of the same level.

Subscriber switched from a marketing opt-in bonus period to an introductory offer within the same level.

The App Store successfully completed the transaction and renewed to a subscription with an introductory offer of a lower level.

Subscriber switched from a marketing opt-in bonus period to an introductory price offer of a lower level.

The App Store successfully completed the transaction and renewed to a subscription with an introductory offer.

The App Store successfully completed the transaction and renewed to a subscription with an introductory price.

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 after previously being subscribed to an introductory offer of a different subscription group.

Subscriber signed up for an introductory offer after previously being subscribed to a subscription with an offer code.

Subscriber signed up for an introductory offer of an equal level after previously being subscribed to a subscription with an offer code.

Subscriber signed up for an introductory offer of a lower level after previously being subscribed to a subscription with an offer code.

Subscriber signed up for an introductory offer of a higher level after previously being subscribed to a subscription with an offer code.

Subscriber moved from a marketing opt-in bonus period to an introductory offer.

Subscriber moved from a paid subscription on a standard price to an introductory offer of a subscription in a different group

Subscriber moved from a paid subscription on a standard price to an introductory offer of a subscription in a different group of the same level.

Subscriber moved from a paid subscription on a standard price to an introductory offer of a subscription in a different group of a lower level.

Subscriber moved from a paid subscription on a standard price to an introductory offer of a subscription in a different group of a higher level.

Subscriber signed up for an introductory offer after previously being subscribed to a subscription offer of a different subscription group.

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 and renewed to a subscription with an introductory offer of a higher level.

Subscriber switched from a marketing opt-in bonus period to an introductory offer of a higher level.

The App Store successfully completed the transaction and renewed to a subscription with an offer code.

The App Store successfully completed the transaction and renewed to a subscription of an equal level with an offer code.

The App Store successfully completed the transaction and renewed to a subscription of a lower level with an offer code.

The App Store successfully completed the transaction and renewed to a subscription of a higher 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 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 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 signed up for a subscription with an offer code after previously redeeming an introductory offer.

Subscriber switched from an introductory offer to a subscription with an offer code of an equal level.

Subscriber switched from an introductory offer to a subscription with an offer code of a lower level.

Subscriber switched from an introductory offer to a subscription with an offer code of a higher level.

Subscriber moved from a marketing opt-in bonus period to a subscription with an offer code.

Subscriber switched from a marketing opt-in bonus period to a subscription with an offer code within the same level in the same subscription group.

Subscriber switched from a marketing opt-in bonus period to a subscription with an offer code of a lower level.

Subscriber switched from a marketing opt-in bonus period to a subscription with an offer code of a higher level.

Subscriber moved from a paid subscription on a standard price to a subscription with an offer code.

Subscriber moved from a paid subscription on a standard price to a subscription with an offer code of an equal level.

Subscriber moved from a paid subscription on a standard price to a subscription with an offer code of a lower level.

Subscriber moved from a paid subscription on a standard price to a subscription with an offer code of a higher level.

Subscriber signed up for a subscription with an offer code after previously redeeming a promotional offer.

Subscriber switched from a promotional subscription offer to a subscription with an offer code of an equal level.

Subscriber switched from a promotional subscription offer to a subscription with an offer code of a lower level.

Subscriber switched from a promotional subscription offer to a subscription with an offer code of a higher level.

Start of a subscription with a marketing opt-in bonus period.

The App Store successfully completed the transaction and renewed the subscription with a marketing opt-in bonus period.

Subscriber switched from an introductory offer to marketing opt-in bonus period.

Subscriber signed up for marketing opt-in bonus period offer after previously being subscribed to a subscription with an offer code.

Subscriber moved to a marketing opt-in bonus period from a subscription offer.

Subscriber switched from an introductory offer to a standard price subscription.

Subscriber switched from an introductory offer to a standard price subscription.

Subscriber switched from a subscription with an offer code to a standard price subscription.

Subscriber switched from a subscription with an offer code to a standard price subscription within the same level in the same subscription group.

Subscriber switched from a subscription with an offer code to a standard price subscription of a lower level.

Subscriber switched from a subscription with an offer code to a standard price subscription of a higher level.

Subscriber switched from a marketing opt-in bonus period to a standard price subscription.

Subscriber switched from a promotional offer to a standard price subscription.

Subscriber switched from a subscription offer to a standard price subscription of a lower level.

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 and renewed to a subscription with a subscription offer.

The App Store successfully completed the transaction and renewed to a subscription offer of an equal price

The App Store successfully completed the transaction and renewed to a subscription offer of a lower price.

The App Store successfully completed the transaction and renewed to a subscription offer of a higher price.

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.

Subscriber signed up for a subscription offer after previously redeeming a promotional offer.

Subscriber switched from an introductory offer to a subscription offer of an equal level.

Subscriber switched from an introductory offer to a subscription offer of a lower level.

Subscriber switched from an introductory offer to a subscription offer of a higher level.

Subscriber signed up for a promotional subscription offer after previously redeeming an offer code.

Subscriber switched from a subscription with an offer code to a promotional subscription offer of an equal level.

Subscriber switched from a subscription with an offer code to a promotional subscription offer of a lower level.

Subscriber switched from a subscription with an offer code to a promotional subscription offer of a higher level.

Subscriber moved from a marketing opt-in bonus period to a subscription offer.

Subscriber switched from a marketing opt-in bonus period to a subscription offer within the same level in the same subscription group. The crossgrade goes into effect at the end of the opt-in bonus period.

Subscriber switched from a marketing opt-in bonus period to a subscription offer of a lower level.

Subscriber switched from a marketing opt-in bonus period to a subscription offer of a higher level.

Subscriber switched from a subscription at the standard price to a subscription offer.

Subscriber signed up for a subscription of the same level from the same subscription group after redeeming a subscription offer. The Crossgrade goes into effect immediately.

Subscriber signed up for a subscription of a lower level from the same subscription group after redeeming a subscription offer. The Downgrade goes into effect immediately.

Subscriber signed up for a subscription of a higher level from the same subscription group after redeeming a subscription offer. The Upgrade goes into effect immediately.

Subscriber signed up for a standard price subscription after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for an introductory offer after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for a paid subscription of an equal level from the same subscription group after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for an introductory offer of an equal level from the same subscription group after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for a paid subscription of a lower level from the same subscription group after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for an introductory offer of a lower level from the same subscription group after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for a paid subscription of a higher level from the same subscription group after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for an introductory offer of a higher level from the same subscription group after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for a subscription with an offer code after previously canceling.

Subscriber signed up for a subscription with an offer code of an equal level from the same subscription group after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for a subscription with an offer code of a lower level from the same subscription group after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for a subscription with an offer code of a higher level from the same subscription group after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for a marketing opt-in from the same subscription group after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for a subscription offer after previously canceling.

Subscriber signed up for a subscription offer of an equal level from the same subscription group after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for a subscription offer of a lower level from the same subscription group after previously canceling. The reactivation goes into effect immediately.

Subscriber signed up for a subscription offer of a higher level from the same subscription group after previously canceling. The reactivation goes into effect immediately.

Subscriber received a refund of the subscription.

Subscriber received a refund of the subscription after a renewal extension.

Subscriber received a renewal extension to an introductory offer.

Subscriber received a renewal extension to a subscription with an offer code.

Subscriber received a renewal extension to a subscription with a marketing opt-in bonus period.

Subscriber received a renewal extension to a standard price subscription.

Subscriber received a renewal extension to a promotional offer.

The App Store successfully completed the transaction and renewed the subscription.

Start of a temporary lower price for a new user.

Start of a subscription with an offer code.

Start of a subscription, without an introductory price or marketing opt-in bonus period.

Subscriber switched from a standard price subscription in a lower level to a subscription in a higher level in the same subscription group. A Subscription counts as upgraded when it goes into effect immediately.

The App Store successfully completed the transaction and switched from a subscription in a lower level to a subscription in a higher level.

The App Store successfully completed the transaction within a 6 or 16 Billing Grace Period window, and switched from a subscription in a lower level to a subscription in a higher level.

When a customer switches from a subscription in a lower level to a subscription in a higher level. The introductory offer ends immediately and the customer’s prorated amount from the prior in-app purchase 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 upgrade date.

When a customer switches from an introductory offer subscription in a lower level to a standard price subscription in a higher level. The introductory price ends immediately and the customer’s prorated amount from the prior in-app purchase 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 upgrade date.

Subscriber switched from a marketing opt-in bonus period to a standard price subscription in a higher level in the same subscription group. The upgrade goes into effect at the end of the opt-in bonus period.