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 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.