Analytics, Subscriptions

Subscription reports fields and definitions

Creators with an Apple Podcasters Program membership who have at least one active subscription can access next-day, downloadable reporting in Apple Podcasts Connect to measure the performance of their subscriptions.

Reports are downloaded directly from Apple Podcasts Connect. You can also automate downloading of reports using Reporter. Learn more about how to measure key performance indicators found in these reports.

Download Reports

  1. In Apple Podcasts Connect, click the Analytics tab.
  2. Choose the Reports tab.
  3. Scroll to the report that you want to download.
  4. Choose a date or report period.
  5. Click Download.
  6. Double-click to unzip the file.
  7. Open the extracted tab-delimited text (.txt) file in a spreadsheet application.
  8. On macOS, Control-click the tab-delimited text (.txt) file to open a shortcut menu and choose Open With.
  9. Right-click to open a shortcut menu on Windows.

Subscription Snapshot Report

Report type: Daily

Requirement: At least one one subscription is sold.

These contain the cumulative number of active subscriptions on a specific date, allowing you to create a daily state view for all your active subscriptions.

Note: Because these reports are snapshots, subscriber counts found in each report should not be summed across days or reports, or your counts will be inflated.

Report Field Type Definition
Report Date Date The date of the reporting period.
Storefront Name String The iso2a code representing the Apple storefront of the subscription.
Channel Apple ID Integer The Apple ID for the channel.
Channel Name String The name of the channel.
Subscription Apple ID BigInt The Apple ID of your subscription.
Subscription Name String The name of the subscription provided by you during its creation.
Subscription State String The current state the subscription is in (Full Paid, Intro Offer, Error Grace, Error Retry).
Subscription Sub-Type String The type of introductory offer.
Subscription Duration String The length of the subscription offered to the customer.
Device String The type of device where the event occurred.
Customer Price Decimal The price charged to the customer.
Customer Currency String The iso3a code indicating the customer’s currency.
Developer Proceeds Decimal The per-unit proceeds for each item delivered.
Proceeds Currency String The iso3a code indicating the currency of your proceeds.
Preserved Pricing String When a subscription renews and the price is preserved, this field equals “Yes.” Otherwise, it is blank.
Proceeds Reason String When a subscription renews and the subscription has been active for more than a year, 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.
Subscription Count Integer The cumulative number of active subscriptions.


Subscription Events Report

Report type: Daily

Requirement: At least one event has occurred during the reported date.

These contain aggregated information about subscription events such as renewals and conversions.

Report Field Type Definition
Report Date Date The date of the reporting period.
Storefront Name String The iso2a code representing the Apple storefront of the subscription.
Event Date Date The date the event occurred.
Channel Apple ID Integer The Apple ID for the channel.
Channel Name String The name of the channel.
Event Name String The type of event occurred.
Subscription Apple ID BigInt The Apple ID of your subscription.
Subscription Name String The name of the subscription provided by you during its creation.
Subscription Sub-Type String The type of introductory offer.
Subscription Duration String The length of the subscription offered to the customer.
Subscription Start Date Date The date of the cohort week of the subscription’s start date, where weeks begin on Monday.
Device String The type of device where the event occurred.
Previous Subscription Apple ID BigInt The Apple ID of the previous subscription.
Previous Subscription Name String The name of the previous subscription.
Preserved Pricing String When a subscription renews and the price is preserved, this field equals “Yes.” Otherwise, it is blank.
Proceeds Reason String When a subscription renews and the subscription has been active for more than a year, 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.
Cancellation Reason String Reason for a cancellation: Billing issue, Price increase, Canceled, Removed from Sale, or Other.
Quantity Integer The number of events with the same reported values.


Subscription Events Definitions

These are the types of events you might see in your Subscription Events Report.

Event Field Definition
Billing Retry from Grace Period Apple was unable to complete renewal of a subscription during the 28-day grace period due to a billing issue. Subscriber enters a 32-day billing retry period.
Cancel Subscriber opted not to renew a subscription from within their Apple 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.
Canceled from Billing Retry Subscriber canceled their subscription during the 32-day billing retry period.
Canceled from Grace Period Subscriber canceled their subscription during the 28-day grace period.
Crossgrade Subscriber switched to a standard price subscription of a different duration. 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.
Crossgrade from Billing Retry Apple successfully completed the transaction within the 32-day billing retry period and renewed to a standard price subscription of a different duration.
Crossgrade from Billing Retry after Introductory Offer Apple successfully completed the transaction within the 32-day billing retry period and renewed an introductory offer to a standard price subscription of a different duration.
Crossgrade from Introductory Offer Subscriber switched to a standard price subscription from an introductory offer having a different subscription duration. The crossgrade goes into effect on the customer’s next renewal date.
Grace Period from Introductory Offer Apple was unable to complete the transaction of renewing an introductory offer to a standard price subscription due to a billing issue, and the subscription enters a 28-day grace period.
Grace Period from Paid Subscription Apple was unable to complete the transaction of renewing a standard price subscription due to a billing issue, and the subscription enters a 28-day grace period.
Introductory Offer Crossgrade from Billing Retry Apple successfully completed the transaction within the 32-day billing retry period and renewed to a subscription with an introductory offer having a different duration.
Introductory Offer from Billing Retry Apple successfully completed the transaction within the 32-day billing retry period and renewed to a subscription with an introductory offer.
Introductory Offer from Grace Period Apple successfully completed the transaction within the 28-day grace period and renewed to an introductory offer.
Introductory Offer from Grace Period with Crossgrade Apple successfully completed the transaction within the 28-day grace period and renewed to an introductory offer of a subscription having a different duration.
Introductory Offer from Introductory Offer Subscriber signed up for an introductory offer after previously being subscribed to an introductory offer.
Introductory Offer from Paid Subscription with Crossgrade Subscriber moved from a subscription on a standard price to an introductory offer of a subscription having a different duration.
Paid Subscription from Introductory Offer Subscriber switched from an introductory offer to a standard price subscription.
Reactivate Subscriber signed up for a standard price subscription after previously canceling. The reactivation goes into effect immediately.
Reactivate to Introductory Offer Subscriber signed up for an introductory offer after previously canceling. The reactivation goes into effect immediately.
Reactivate with Crossgrade Subscriber signed up for a standard price subscription after previously canceling a subscription of a different duration. The reactivation goes into effect immediately.
Reactivate with Crossgrade to Introductory Offer Subscriber signed up for an introductory offer after previously canceling a subscription of a different duration. The reactivation goes into effect immediately.
Refund Subscriber received a refund of the standard price subscription.
Renew Subscriber renews a standard price subscription.
Renewal from Billing Retry Apple successfully completed the transaction within the 32-day billing retry period and renewed the standard price subscription.
Renewal from Billing Retry After Introductory Offer Apple successfully completed the transaction within the 32-day billing retry period and renewed an introductory offer to a standard price subscription.
Renewals from Grace Period Apple successfully completed the transaction within the 28-day grace period and renewed a standard price subscription.
Renewals from Grace Period after Introductory Offer Apple successfully completed the transaction within the 28-day grace period and renewed an introductory offer to a standard price subscription.
Start Introductory Offer Start of a temporary lower price for a new user.
Subscribe Start of a standard price subscription without an introductory price period.


Subscription Sales Summary Report

Report type: Daily

Requirement: At least one subscription is purchased.

These contain aggregated information about subscription purchases such as price, proceeds, and units sold.

Report Field Type Definition
Report Start Date Date First date of the specified reporting period.
Report End Date Date Last date of the specified reporting period. This will be the same as Report Start Date for Daily reports.
Storefront Name String The iso2a code representing the Apple storefront of the subscription.
Channel Apple ID Integer The Apple ID for the channel.
Channel Name String The name of the channel.
Apple Identifier BigInt The unique Apple identifier for the given subscription.
Channel Subscription String The name of the subscription provided by you during its creation.
Device String The type of device where the purchase occurred. Possible values include:
iPad
iPhone
Mac (such as an iMac or MacBook)
Other (which includes iPod Touch and Vision Pro)
Sale / Refund String Indicates if a transaction is a sale or return. Possible values include:
S = Sale
R = Refund
Customer Price Decimal Price charged to the customer. Negative values indicate refunds.
Customer Currency String The iso3a code indicating the customer’s currency.
Currency of Proceeds String The iso3a code indicating the currency of your proceeds.
Developer Proceeds Decimal The per-unit proceeds for each item delivered.
Units Integer The aggregate number of units sold. Negative values indicate refunds.


Listening Report

Report type: Monthly

Requirement: At least one play on an episode.

This monthly report contains aggregated information about listenership of your content, including number of hours listened, type of listener, and number of plays, by storefront, episode, and episode type.

To access this report, you’ll need to be a member of the Apple Podcasters Program with a contract in effect and at least one play on an episode. It may take 24 hours for reports to appear.

The term “subscribers” refers to listeners who are in an active paid subscription or in a free trial period. The term “listeners” refers to nonsubscribers. They may or may not be followers of your show.

“Connected listeners” and “connected plays” refers to listeners or plays from a connected App Store subscription.

Report Field Type Definition
Storefront Name String The iso2a code representing the Apple storefront of the subscription.
Show Identifier Integer The Apple Podcasts Show ID.
Show Name String The name of the show.
Episode Identifier Integer The Apple Podcasts Episode ID.
Episode Name String The name of the episode.
Episode GUID String The episode’s global unique identifier (GUID).
Episode Type String Indicates whether the play was on an episode that was Apple hosted ("PSUB"), Apple hosted/free (“Plus”), or from an RSS feed (“STDQ").
Total Listening Hours Decimal Aggregated listening time displayed in hours.
Subscriber Listening Hours Decimal Aggregated listening time of subscribers displayed in hours.
Non-Subscriber Listening Hours Decimal Aggregated listening time of non-subscribers displayed in hours.
Connected Listening Hours Decimal Aggregated listening time of listeners connected through an App Store or a linked purchased subscription displayed in hours providing one decimal place.
Total Listeners Integer Aggregated count of listeners that have played more than 0 seconds of an episode.
Subscribed Listeners Integer Aggregated count of listeners with a subscription that have played more than 0 seconds of an episode.
Non-Subscribed Listeners Integer Aggregated count of listeners without a subscription that have played more than 0 seconds of an episode.
Connected Listeners Integer Aggregated count of unique devices coming from listeners connected through an App Store or a linked purchased subscription that have played more than 0 seconds of an episode.
Total Engaged Listeners Integer Aggregated count of listeners that played at least 20 minutes or 40% of an episode within a single session across the entire reporting period.
Subscribed Engaged Listeners Integer Aggregated count of listeners with a subscription that played at least 20 minutes or 40% of an episode within a single session across the entire reporting period.
Non-Subscribed Engaged Listeners Integer Aggregated count of listeners without a subscription that played at least 20 minutes or 40% of an episode within a single session across the entire reporting period.
Connected Engaged Listeners Integer Aggregated count of unique devices coming from listeners connected through an App Store or a linked purchased subscription that played at least 20 min or 40% of an episode within a single session across the entire reporting period.
Total Plays Integer Aggregated count of plays where the play duration is greater than 0 seconds.
Subscriber Plays Integer Aggregated count of plays coming from subscribers with a subscription where the play duration is greater than 0 seconds.
Non-Subscriber Plays Integer Aggregated count of plays coming from listeners without a subscription where the play duration is greater than 0 seconds.
Connected Plays Integer Aggregated count of plays coming from listeners connected through an App Store or a linked purchased subscription where the play duration is greater than 0 seconds.

Related Content

Analytics, Subscriptions
Understanding your subscription reports
Measure your subscription churn rate, find key performance indicators, and learn about subscription reports.
Understanding your subscription reports