About Sales and Trends

Sales and Trends is a data visualization tool that allows you to view the performance of your content on Apple Music and the iTunes Store.

There are four main areas in Sales and Trends:

Overview combines streams and sales data to provide a single view of your music’s performance on Apple Music and the iTunes Store.
Sales provides deeper insight into your units, proceeds, and pre-orders with options to group and filter data by selected time period, territory, and more.
Streams displays detailed information about Apple Music streaming activity, including user engagement.
Saved views is where you can manage your customized filters.

Sales and Trends reports include all transactions of the day, and are provided so that you can get next-day data on your business. Units and proceeds from Sales and Trends are only estimates and should not be considered final. For finalized information about your payments, go to Payments and Financial Reports.

Note: iTunes Connect users must have the Admin, Finance, Legal, or Sales role to access Sales and Trends, or to download reports. This ensures that only authorized users have access to your company’s confidential information. To manage access, go to Users and Roles.

Overview

About Overview

Overview summarizes your streaming and sales activity on a single page, enabling you to quickly view the performance of your songs on Apple Music and the iTunes Store.

By default, you will see data for the past month, detailing your total streams, sales units, proceeds, and pre-orders. To view data for an earlier 30 day period, select a custom end date.

Percentages in green or red show the change month-over-month. For example, if you select an end date of May 12, the percentage change will compare your total streams from Apr 13 to May 12 to your total streams between March 13 to Apr 12.

Compare sales units and streaming equivalents

Streaming equivalents allow you to directly compare your content’s performance on Apple Music and the iTunes Store.

One sales unit is equivalent to 125 streams. Hover over the chart to view units and equivalents for each day.

Compare sales units and streaming equivalents

View top streaming songs

After your content has been available on Apple Music for at least seven days, you will be able to view weekly data to help you better understand how members are finding and interacting with your music. Top Streaming Songs includes:

Total Song Streams. The total number of times that song was played in Apple Music.
Library Streams. Represents the percentage of plays that were initiated after the song was saved to a member’s library.
Discovery Streams. Represents the percentage of plays that were initiated from For You, Browse, and Radio.
Sales Units. The total number of times your song was purchased on the iTunes Store.
Sales Proceeds. The total amount of proceeds earned from sales of that song on the iTunes Store. This does not include royalty payments for streaming content.

By default, data for the past seven days will be displayed. To view earlier information, select a custom end date.

Library, Discovery, and Search charts show you where your streams originate. Hover your cursor over each chart to see streams per day.

Library, Discovery, Search stream charts

View top playlists

If your content is featured in editorial or curator playlists, you can view data on:

Total Song Streams. The number of times your songs were streamed from that playlist. If multiple songs were included in a single playlist, this figure reflects the total number of streams for of all of your songs included in that playlist.
Previous 7 Days. The percentage difference between the total number of streams that occurred this week compared to the total number of streams that occurred during the previous seven days.
Completion Rate. The average percentage of your streams on the playlist that were played to completion.

By default, this page displays data for the past seven days. Select a custom end date to view data further back in time.

Note: The measures on this page include just streams of your songs. Information about songs that you do not deliver to Apple are excluded from Sales and Trends and your reports.

Measure by territory or artist

On the overview page, you can view sales and stream totals split by Territory and/or Artist.

From the iTunes Connect homepage, click Sales and Trends.
On the left side, select Overview.
In the upper-right corner, choose a date. Data in the graphs will change based on the chosen end date.
Click Add Filters at the top left of the page to filter by Territory or Artist.

Streams and Sales

View streams

Streams on Apple Music can be measured and analyzed using filters and custom date ranges. Note that figures displayed in Sales and Trends are an approximation, and should not be considered exact royalty-bearing counts. Finalized earnings for Apple Music streams can be viewed and downloaded in Payments and Financial Reports.

By default, data for the past seven days will be displayed. To view a wider date range, or data for a period earlier than the past seven days, click the calendar in the upper-right corner.

Below the graph, you’ll find detailed information about the following:

Content type. This denotes whether the content is a song or music video.
ID. The Apple ID for the song, also displayed on the album page in My Music.
Streams. The total number of streams on Apple Music, including plays on Apple Music Radio.
Previous Range. This is the change between the previous and current date period.

Add filters: View more focused data based on specific dimensions such as content type, member type, and playlist/radio. You can add multiple dimensions to see more granular data.

Note: Data is refreshed and updated every 8 hours.

View sales

Measure your iTunes Store sales units, proceeds, and pre-orders over time. Pre-orders defaults to Net pre-orders, or total pre-orders less cancellations. Percentages indicate the change between the previous and current date range.

By default, data for the past seven days will be displayed. To view a wider date range, or data for a period earlier than the past seven days, click the calendar in the upper-right corner.

Below the graph, you’ll see information about pre-orders in the following states:

Pre-orders. The total number of pre-orders placed by customers less cancellations, within the selected date range.
Ordered. The total number of pre-orders that were placed and have not yet been fulfilled within the selected date range.
Fulfilled. Orders are fulfilled once payment has been accepted and the customer has been provided a link to download the song.
Canceled. The total number of pre-orders that customers canceled within the selected date range.
Open. Pre-orders that have not yet been fulfilled or canceled, likely because the sales start date is still in the future.

Add filters: View more focused data based on specific dimensions such as content type, member type, and playlist/radio. You can add multiple dimensions to see more granular data.

Note: Data is refreshed and updated every eight hours.

See alsoCreate saved views

Create saved views

You can save your current chosen date range, group, and filter selections. You can later choose your saved views from the menu under Saved on the left side.

On the left side, select the + next to Saved Views.
Give the saved view a name and click Save.
Return to your saved view at any time by choosing it from the Saved section on the left side.

Create custom territory groups

You can create custom territory groups that filter your content according to territories you’ve selected.

Click Add Filters and select Territory.
Select Create Custom Territory Group.
Click the + icon and enter a name for your Custom Territory Group. Select the relevant countries by checking the box to the left of each country and click Save.
To use a Custom Territory Group, click Add Filters and select Territory. Your new Custom Territory Group is now visible under My Groups.

Export data

You can download the data displayed in the graph for use outside of Sales and Trends.

To save graph data:

Click the download button at the upper-right corner of the graph, above the data table.
Select the download format. You can download data in either CSV or Excel formats, or export to your computer’s clipboard.

Reports

About Reports

Types

Apple Music Reports

Availability for daily Apple Music reports: 08:00 PST (UTC-8) one day, or 24 hours, later.

These reports include data about listener activity and demographics. The following reports are available for music providers who have at least one royalty-bearing stream:

Apple Music Content Reports. Aggregated data for your content’s availability for streaming on Apple Music.
Apple Music Summary Streams Reports. Data about Apple Music subscriber activity, including plays and skips.
Apple Music Container Summary Reports. Aggregated information about individual playlists and radio stations from which your content is played.
Apple Music Content Demographic Reports. Aggregated data about member listener type, age, and gender, grouped by content, such as the Apple Identifier for a specific song.
Apple Music Artist Demographic Reports. Aggregated data about member listener type, age, and gender, grouped by artist.
Apple Music Library Events Reports. Unique counts of subscribers Library adds and removals for your Pre-Add and released content.
Apple Music Total Library Adds Reports. Total unique counts of subscribers Library adds for your Pre-Add and released content.
Apple Music Editorial Playlist Adds Reports. Additions, removals, and track number updates for your content on Apple Music Editorial Playlists.

Shazam Reports

Availability for daily Shazam reports: 06:00 PST (UTC-8) the following day.

The following report is available to music providers who have at least one song matched by a Shazam request.

Daily Shazam Reports. Aggregated data for Shazams, including date, artist, title, city, and country.

Sales Reports

Availability for daily sales reports: 06:00 PST (UTC-8) the following day.

The following reports are available to music providers who have at least one unit sold, or one royalty-bearing stream:

Detailed Pre-Order Reports. Transaction-level data for pre-order activity, including details about ordered, canceled, and fulfilled orders.
Detailed Sales Reports. Transaction-level sales and download data.
Summary Pre-Order Reports. Aggregated data for pre-order activity, including details about ordered, canceled, and fulfilled orders.
Summary Sales Reports. Aggregated sales and download data for your content on the iTunes download store.
Content Demographic Reports. Aggregated data about customer age and gender, grouped by content, such as the Apple Identifier for a specific song.
Artist Demographic Reports. Aggregated data about customer age and gender, grouped by artist.

Time zone: Reports are based on Pacific Standard Time (PST). For detailed information on when weekly, monthly, and yearly reports are available, see Availability.

See alsoDownload reports

Availability

Daily reports are available the following day.
Weekly reports are available on Mondays.
Exception: Apple Music and iTunes Demographic Reports are available on Fridays.
Monthly reports are available five days after the last day of the month.
Yearly reports are available six days after the last day of the year. These reports are saved for ten years.

Note: Daily, weekly, and monthly reports are saved for one year after they become available. We don't store or regenerate reports for download after these time periods expire.

Reports use the following definitions for periods of time:

Term	Definition
Day	Starts at 12:00:00 a.m. and ends at 11:59:59 p.m. in the time zone for a territory.
Week	Starts on Monday at 12:00:00 a.m. and ends on Sunday at 11:59:59 p.m. in the time zone for a territory. Exception: Apple Music and iTunes Demographic Reports start on Friday at 12:00:00 a.m. and end on Thursday at 11:59:59 p.m. in the time zone for a territory.
Month	Starts on the first day of the month at 12:00:00 a.m. and ends on the last day of the same month at 11:59:59 p.m. in the time zone for a territory.
Year	Starts on January 1 at 12:00:00 a.m. and ends on December 31 at 11:59:59 p.m. in the time zone for a territory.

Note: Sales and Trends reports are not based on Apple’s fiscal calendar.

Download reports

Sales and Trends reports are available for download from the Reports page. You can also automate report downloads using the command-line tool, Reporter.

Download from Sales and Trends

From the iTunes Connect homepage, click Sales and Trends.
On the left side, choose Sales and Trends Reports.
Locate the Report that you want to download.
Choose a vendor and date or report period.
Click Download.

View reports

Reports are formatted as tab-delimited text (.txt) files, compressed in gzip (.gz) format. To view a downloaded report:

Unzip the compressed gzip (.gz) file by opening it or using a utility.
On macOS, double-click on the compressed gzip (.gz) file to unzip it.
Open the extracted tab-delimited text (.txt) file in a spreadsheet application.
On macOS, control-click the tab-delimited text (.txt) file to open a shortcut menu and select Open With.
On Windows, right-click to open a shortcut menu.

The following reports are further split into separate files and/or compressed into a zip (.zip) file:

Apple Music Summary Streams Report

Apple Music Control report (used for Reporter downloads only)

These reports are tab-delimited text (.txt) files compressed in gzip (.gz) format and wrapped in a single .zip file. Reports over 8 million rows are first split into individual files, then compressed. To track how many files belong in a single report, file names are appended with a [X-Z] where X represents the file number of the set and Z represent the total files contained.

Download Report

To view a downloaded report:

Unzip the compressed zip file (.zip) by opening it or using a utility.
Unzip the compressed gzip (.gz) file by opening it or using a utility.
On macOS, double-click on the compressed gzip (.gz) file to unzip it.
Open the extracted tab-delimited text (.txt) file in a spreadsheet application.
On macOS, control-click the tab-delimited text (.txt) file to open a shortcut menu and select Open With.
On Windows, right-click to open a shortcut menu.

Apple Music

Apple Music Content Reports

Report type: Daily

Requirement: At least one stream is played.

These contain aggregated information about your content’s availability for streaming on Apple Music.

Report Field	Type	Notes
Apple Identifier	BigInt	Unique Apple identifier for the given piece of content, for example 2866241444.
ISRC	String	This is the ISRC or ISBN for a given piece of content. You provide this when you deliver your content.
Title	String	The title of the content. You provide this when you deliver your content.
Artist	String	The primary artist of the item. You provide this when you deliver your content.
Artist ID	BigInt	Apple identifier for the given artist. This will match the Artist ID used when delivering your content.
Item Type	BigInt	Indicates iTunes Store or Apple Music content. Possible values include: 1 = iTunes Store or Apple Music Content
Media Type	BigInt	The item media type. Possible values include: 1 = Music 2 = Music Video
Media Duration	BigInt	The duration of content being played (in seconds).
Vendor Identifier	String	A unique vendor ID you provide to us when submitting your content.
Label/Studio/Network	String	The Label, Studio, or Network provided when you delivered the content.
GRid	String	The Global Release Identifier, provided by you during content delivery.
Secondary ISRC	String	The secondary ISRC associated to a single Apple identifier, provided by you during content delivery.

Apple Music Summary Streams Reports

Report type: Daily

Requirement: At least one stream is played.

These contain aggregated information about listener subscription type, approximate time, and activity such as plays and skips for streams over the royalty-bearing minimum threshold of 30 seconds.

Report Field	Type	Notes
Datestamp	Date	Datestamp when the event occurred (format YYYY-MM-DD) on the device in local time.
Ingest Datestamp	Date	Datestamp when the event was reported to Apple (format YYYY-MM-DD).
Apple Identifier	BigInt	Unique Apple identifier for the given piece of content. This will match the Apple ID used in the Apple Music Trend Content report.
Storefront Name	String	The two-character ISO country code that indicates which iTunes territory the activity occurred, for example, US.
Time Bucket	BigInt	The local time period when the action occurred. Possible values include: 1 = Between 00:00 and 02:59 2 = Between 03:00 and 05:59 3 = Between 06:00 and 08:59 4 = Between 09:00 and 11:59 5 = Between 12:00 and 14:59 6 = Between 15:00 and 17:59 7 = Between 18:00 and 20:59 8 = Between 21:00 and 23:59 * Starting on April 8, 2016, Time Buckets are shown in the customer’s local time, rather than UTC.
Subscription Type	String	Subscription used at the time of playback, for example, Individual Monthly or Family Monthly.
Subscription Mode	String	Subscription status at the time of playback, for example, Paid or Trial.
Channel Partner	String	Third-party partner through which the membership is offered (for example, Telstra, EE, DT).
Device Type	Int	The type of device where the event occurred. Possible values include: 0 = Other 1 = Mobile (such as an iPhone, iPad, or iPod touch) 2 = Desktop (such as an iMac or MacBook Air) 3 = Voice (such as HomePod or Amazon Echo)
Source of Stream	Int	Indicates where the play originated in the app. Possible values include: 0 = Other 1 = Library 2 = Search 3 = Discovery 4 = MusicKit 5 = External 6 = Now Playing 7 = Voice
Container Type	Int	Indicates the context from which the play originated. Possible values include: 0 = Single Track 1 = Radio Station 2 = Playlist 3 = Album
Container Sub-Type	Int	The type of playlist or radio station from which the play occurred. Possible values include: 0 = Not Applicable 1 = Private User Playlist 2 = Editorial Playlist 3 = Artist Playlist 4 = Curator Playlist 5 = Seeded by Artist/Song 6 = Format Station 7 = Editorial Station 8 = Personal Mix Playlist 9 = New Music Mix 10 = Favorites Mix 11 = Chill Mix 12 = Get Up! Mix 13 = Friends Mix 14 = Algorithm Station 15 = Replay Mix 16 = Autoplay Station 17 = Charts Playlist 18 = Artist Station 19 = Personal Station 20 = Album 21 = Discovery Station 22 = Love Mood Station 23 = Heartbreak Mood Station 24 = Focus Mood Station 25 = Energy Mood Station 26 = Relax Mood Station 27 = Feeling Good Mood Station 28 = Feeling Blue Mood Station
Container ID	String	The unique identifier assigned to the playlist and radio station container by Apple. We do not include a Container ID for user playlists or any playlist/radio station that can help identify a user. Each row must meet or exceed 50 royalty-bearing plays before Container ID will be displayed in the report.
Container Name	String	The name of the playlist or radio station where the play originated. We do not include a Container Name for user playlists. Each row must meet or exceed 50 royalty-bearing plays before Container Name will be displayed in the report.
End Reason Type	Int	Indicates the reason playback ended. Possible values include: 0 = Complete (the whole track was played) 1 = Skip (the listener skipped the song) 2 = Other (playback ended for other reasons, such as scrubbing the content) 3 = Manually Changed (the listener manually changed the song) 4 = Paused (the playback was paused or interrupted)
Offline	BigInt	Indicates that the play occurred while the device was offline, for example, a cached stream. Possible values include: 0 = Online 1 = Offline
Audio Format	String	The audio format that was delivered to the listener. Possible values include: Compressed Audio Lossless Immersive
Streams	BigInt	The number of royalty-bearing streams.

Apple Music Container Summary Reports

Report type: Daily

Requirement: At least five streams are played within the playlist or radio station for the reported row.

This report contains aggregated information about individual playlists and radio stations from which your content is played.

Report Field	Type	Notes
Ingest Datestamp	Date	Datestamp when the event was reported to Apple (format YYYY-MM-DD).
Storefront Name	String	The two-character ISO country code that indicates in which territory the activity occurred, for example, US.
Apple Identifier	BigInt	Unique Apple identifier for the given song.
Container Type	Int	Indicates the context from which the play originated. Possible values include: 0 = Single Track 1 = Radio Station 2 = Playlist 3 = Album
Container Sub-Type	Int	The type of playlist or radio station from which the play occurred, providing further detail into where the play originated. Possible values include: 2 = Editorial Playlist 3 = Artist Playlist 4 = Curator Playlist 5 = Seeded by Artist/Song 6 = Format Station 7 = Editorial Station 17 = Charts Playlist 21 = Discovery Station 22 = Love Mood Station 23 = Heartbreak Mood Station 24 = Focus Mood Station 25 = Energy Mood Station 26 = Relax Mood Station 27 = Feeling Good Mood Station 28 = Feeling Blue Mood Station
Container ID	String	The unique identifier assigned to the playlist and radio station container by Apple. We do not include a Container ID for user playlists.
Container Name	String	The name of the playlist or radio station where the play originated. This reflects what a listener sees in Apple Music. We do not include a Container Name for user playlists.
Streams	BigInt	The number of royalty-bearing streams.

Apple Music Content Demographic Reports

Report type: Daily

Requirement: At least five unique listeners streamed this content per each row in this file.

These contain aggregated information about listener membership type, age, and gender.

Report Field	Type	Notes
Report Date	String	The reporting date of the report (format YYYY-MM-DD).
Apple Identifier	BigInt	Unique Apple identifier for the given piece of content. This will match the Apple ID used in the Apple Music Trend Content report.
Storefront Name	String	The two-character ISO country code that indicates in which iTunes territory the activity occurred, for example, US.
Subscription Type	String	Subscription used at the time of playback, for example, Individual Monthly or Family Monthly.
Subscription Mode	String	Subscription status at the time of playback, for example, Paid or Trial.
Action Type	BigInt	The action or event happening (for example, seeing a 1 indicates this track has been played). Possible values include: 1 = Play
Gender	Int	Indicates the gender of the listener. Possible values include: 0 = Data Unknown 1 = Male 2 = Female
Age Band	String	The age bucket the listener belongs to. Possible values include: 18-24 25-34 35-44 45-54 55-64 65+ Data Unknown
Audio Format	String	The audio format that was delivered to the listener. Possible values include: Compressed Audio Lossless Immersive
Listeners	BigInt	The unique count of listeners.
Streams	BigInt	The number of royalty-bearing streams.
Listeners Last 7 Days	BigInt	The unique count of listeners across the previous 7 days. This is inclusive of the Listeners provided for a single day.
Streams Last 7 Days	BigInt	The number of royalty-bearing streams across the previous 7 days. This is inclusive of the streams provided for a single day.

Report type: Weekly, Monthly

Requirement: At least five unique listeners streamed this content per each row in this file. These contain aggregated information about listener membership type, age, and gender.

Availability Weekly: Starts on Friday at 12:00:00 AM and ends on Thursday at 11:59:59 PM in the time zone for a territory.

Availability Monthly: Starts on the first day of the month at 12:00:00 AM and ends on the last day of the same month at 11:59:59 PM in the time zone for a territory.

Report Field	Type	Notes
Start Date	Date	The start date of the date range for this report.
End Date	Date	The end date of the date range for this report.
Apple Identifier	BigInt	Unique Apple identifier for the given piece of content. This will match the Apple ID used in the Apple Music Trend Content report.
Storefront Name	String	The two-character ISO country code that indicates in which iTunes territory the activity occurred, for example, US.
Subscription Type	String	Subscription used at the time of playback, for example, Individual Monthly or Family Monthly.
Subscription Mode	String	Subscription status at the time of playback, for example, Paid or Trial.
Action Type	BigInt	The action or event happening (for example, seeing a 1 indicates this track has been played). Possible values include: 1 = Play
Gender	Int	Indicates the gender of the listener. Possible values include: 0 = Data Unknown 1 = Male 2 = Female
Age Band	String	The age bucket the listener belongs to. Possible values include: 18-24 25-34 35-44 45-54 55-64 65+ Data Unknown
Audio Format	String	The audio format that was delivered to the listener. Possible values include: Compressed Audio Lossless Immersive
Listeners	BigInt	The unique count of listeners.
Streams	BigInt	The number of royalty-bearing streams.

Apple Music Artist Demographic Reports

Report type: Daily

Requirement: At least five unique listeners streamed this content per each row in this file. These contain aggregated information about listener membership type, age, and gender.

Report Field	Type	Notes
Report Date	String	The reporting date of the report (format YYYY-MM-DD).
Artist ID	BigInt	Apple identifier for the given artist. This will match the Artist ID used when delivering your content.
Storefront Name	String	The two-character ISO country code that indicates in which iTunes territory the activity occurred, for example, US.
Subscription Type	String	Subscription used at the time of playback, for example, Individual Monthly or Family Monthly.
Subscription Mode	String	Subscription status at the time of playback, for example, Paid or Trial.
Action Type	BigInt	The action or event happening (for example, seeing a 1 indicates this track has been played). Possible values include: 1 = Play
Gender	Int	Indicates the gender of the listener. Possible values include: 0 = Data Unknown 1 = Male 2 = Female
Age Band	String	The age bucket the listener belongs to. Possible values include: 18-24 25-34 35-44 45-54 55-64 65+ Data Unknown
Audio Format	String	The audio format that was delivered to the listener. Possible values include: Compressed Audio Lossless Immersive
Listeners	BigInt	The unique count of listeners.
Streams	BigInt	The number of royalty-bearing streams.
Listeners Last 7 Days	BigInt	The unique count of listeners across the previous 7 days. This is inclusive of the Listeners provided for a single day.
Streams Last 7 Days	BigInt	The number of royalty-bearing streams across the previous 7 days. This is inclusive of the streams provided for a single day.

Report type: Weekly, Monthly

Requirement: At least five unique listeners streamed this content per each row in this file. These contain aggregated information about listener membership type, age, and gender.

Availability Weekly: Starts on Friday at 12:00:00 AM and ends on Thursday at 11:59:59 PM in the time zone for a territory.

Availability Monthly: Starts on the first day of the month at 12:00:00 AM and ends on the last day of the same month at 11:59:59 PM in the time zone for a territory.

Report Field	Type	Notes
Start Date	Date	The start date of the date range for this report.
End Date	Date	The end date of the date range for this report.
Artist ID	BigInt	Apple identifier for the given artist. This will match the Artist ID used when delivering your content.
Storefront Name	String	The two-character ISO country code that indicates in which iTunes territory the activity occurred, for example, US.
Subscription Type	String	Subscription used at the time of playback, for example, Individual Monthly or Family Monthly.
Subscription Mode	String	Subscription status at the time of playback, for example, Paid or Trial.
Action Type	BigInt	The action or event happening (for example, seeing a 1 indicates this track has been played). Possible values include: 1 = Play
Gender	Int	Indicates the gender of the listener. Possible values include: 0 = Data Unknown 1 = Male 2 = Female
Age Band	String	The age bucket the listener belongs to. Possible values include: 18-24 25-34 35-44 45-54 55-64 65+ Data Unknown
Audio Format	String	The audio format that was delivered to the listener. Possible values include: Compressed Audio Lossless Immersive
Listeners	BigInt	The unique count of listeners.
Streams	BigInt	The number of royalty-bearing streams.

Apple Music Library Events Reports

Report type: Daily

Requirement: At least five unique subscribers have added this content to their library per each row within the file. These contain aggregated counts of subscribers’ adds or removes for your pre-add and released content.

Report Field	Type	Notes
Datestamp	Date	Datestamp when the event occurred (format YYYY-MM-DD).
Storefront Name	String	The two-character ISO country code that indicates in which iTunes territory the activity occurred, for example, U.S.
Apple Identifier	BigInt	Unique Apple identifier for the song, album, or music video.
Title	String	The title of the content. You provide this when you deliver your content.
Artist	String	The primary artist of the item. You provide this when you deliver your content.
Artist ID	String	Apple identifier for the given artist. This will match the Artist ID used when delivering your content.
Media Type	BigInt	The type of product being acted upon. Possible values include: 1 = Song 2 = Music Video 3 = Album
Action Type	BigInt	The action or event happening. Possible values include: 3 = Add to Library 4 = Remove from Library 5 = Pre-add to Library 6 = Remove pre-add from Library
Events	Int	Count of events. A minimum of 5 unique users per row is required.

Apple Music Total Library Adds Reports

Report type: Daily

Requirement: At least five unique subscribers have added this content to their library per each row within the file. These contain aggregated net counts of subscribers’ additions for your Pre-Add and released content.

Report Field	Type	Notes
Datestamp	Date	Datestamp when the event occurred(format YYYY-MM-DD).
Apple Identifier	BigInt	Unique Apple identifier for the song, album, or music video.
Title	String	The title of the content. You provide this when you deliver your content.
Artist	String	The primary artist of the item. You provide this when you deliver your content.
Artist ID	String	Apple identifier for the given artist. This will match the Artist ID used when delivering your content.
Media Type	BigInt	The type of product being acted upon. Possible values include: 1 = Song 2 = Music Video 3 = Album
Action Type	BigInt	The action or event happening. Possible values include: 3 = Add to Library 5 = Pre-add to Library
Total Adds	Int	Cumulative count of net pre-adds or library adds (adds less removes). A minimum of 5 unique users per row is required.

Apple Music Editorial Playlist Adds Reports

Report type: Daily

Requirement: At least one song has been added to, removed from, or updated in an Apple Music Editorial Playlist.

These reports include data about songs or music videos that have been updated within an Apple Music Editorial Playlist. Track position is reported only when the Action Type is an Add (7) or an Update (9).

Report Field	Data Type	Description
Datestamp	Date	Datestamp when the event occurred(format YYYY-MM-DD).
Storefront Name	String	The two-character ISO country code that indicates in which iTunes territory the activity occurred, for example, U.S.
Apple Identifier	BigInt	Unique Apple identifier for the song.
Title	String	The title of the content. You provide this when you deliver your content.
Artist	String	The primary artist of the item. You provide this when you deliver your content.
Artist ID	String	Apple identifier for the given artist. This will match the Artist ID used when delivering your content.
Media Type	BigInt	The type of product being acted upon. Possible values include: 1 = Song 2 = Music Video
Action Type	BigInt	The action or event happening. Possible values include: 7 = Add to playlist 8 = Remove from playlist 9 = Update position in playlist
Playlist ID	String	The unique identifier assigned to the playlist by Apple.
Playlist Name	String	The name of the playlist container where the content appears. This reflects what a member sees in Apple Music.
Track Position	BigInt	Current position of the song in the playlist container.

Apple Music Control Reports

These contain MD5 hash values of each of the other Apple Music reports. MD5 hashes can be used to ensure that the data in the reports were not corrupted during download. Daily Apple Music Control reports are only available when downloading using Reporter.

Report Field	Type	Notes
File Name	String	Name of a downloaded Apple Music report, for example, `AppleMusic_Detail_80012345_20150715_part1.txt`.
MD5 Hash Value	String	Computed hash for corresponding report.

Shazam Reports

Report type: Daily

Requirement: At least five unique Shazam users per each row are required.

These contain aggregated information about which songs are being requested via Shazam. Counts are aggregated to the city, state province, country, or worldwide level (whichever is the most granular but meets the 5 or greater value threshold).

Report Field	Type	Notes
Ingest Datestamp	Date	Date stamp when the event was reported to Apple (format: YYYY-MM-DD).
Ingest Hour	Int	The local time period when the action occurred. Possible values include: 0 = 00:00 AM to 00:59 AM 1 = 01:00 AM to 01:59 AM 2 = 02:00 AM to 02:59 AM 3 = 03:00 AM to 03:59 AM 4 = 04:00 AM to 04:59 AM 5 = 05:00 AM to 05:59 AM 6 = 06:00 AM to 06:59 AM 7 = 07:00 AM to 07:59 AM 8 = 08:00 AM to 08:59 AM 9 = 09:00 AM to 09:59 AM 10 = 10:00 AM to 10:59 AM 11 = 11:00 AM to 11:59 AM 12 = 12:00 PM to 12:59 PM 13 = 01:00 PM to 01:59 PM 14 = 02:00 PM to 02:59 PM 15 = 03:00 PM to 03:59 PM 16 = 04:00 PM to 04:59 PM 17 = 05:00 PM to 05:59 PM 18 = 06:00 PM to 06:59 PM 19 = 07:00 PM to 07:59 PM 20 = 08:00 PM to 08:59 PM 21 = 09:00 PM to 09:59 PM 22 = 10:00 PM to 10:59 PM 23 = 11:00 PM to 11:59 PM 24 = Full 24 hour day *Hours are shown in the customer’s local time, rather than UTC.
Title	String	The title of the content.
Artist	String	The item’s artist.
Country	String	The two-character ISO country code that indicates where the Shazam occurred.
State Province	String	The state or province where the Shazam occurred.
City	String	The city or metro area where the Shazam occurred.
ISRC	String	A comma-separated list of ISRC of the song identified by Shazam.
Shazams	BigInt	The total number of Shazams received.

Sales

Summary Sales Reports

Report types: Daily, weekly, monthly, and yearly

Requirement: At least one unit sold.

Tip: To better understand the values below, view a Sample Summary Sales Report.

Report Field	Type	Notes
Provider	String	The service provider in your reports (typically Apple).
Provider Country	String	The service provider country code (typically U.S.).
Vendor Identifier	String	A unique vendor ID you provide us when submitting your content.
UPC	String	The identifying Universal Product Code you provide us when you deliver your content.
ISRC	String	The identifying ISRC you provide us when deliver your content.
Artist / Show	String	The primary artist or show title of the item. You provide this when you deliver your content.
Title	String	The title of the content. You provide this when you deliver your content.
Label/Studio/Network	String	The label, studio, or network you provide when you delivered the content.
Product Type Identifier	String	Defines the type of product. For more information, see Product Type Identifiers.
Units	Decimal	The aggregate number of units sold.
Royalty Price	Decimal	Royalty price for your content.
Begin Date	Date	The start date of your sales summary date range.
End Date	Date	The ending date of your sales summary date range.
Customer Currency	String	Three-character ISO code indicating the customer’s currency. For more information, see Currency Codes.
Country Code	String	Two-character ISO country code indicating the iTunes Store or Apple Music territory for the purchase. For more information, see Country Codes.
Royalty Currency	String	Three-character ISO code indicating the royalty currency. For more information, see Currency Codes.
PreOrder	String	"Indicates if the transaction is a pre-order. If the purchase is not a pre-order, this field will be blank. Possible values include: P = Pre-Order"
ISAN	String	The identifying ISAN you provide us when deliver your content.
Apple Identifier	BigInt	Unique Apple identifier for the given piece of content.
Customer Price	Decimal	Price displayed on the iTunes Store.
CMA	String	CMA sales are marked with CMA in the field. Song credits are marked CMA-C. Sales and refunds field are marked with R.
Asset/Content Flavor	String	Only applicable to TV content. High Definition content is marked with HD. Standard Definition is marked SD or blank.
Vendor Offer Code	String	Provided by you during content delivery.
GRid	String	The Global Release Identifier, provided by you during content delivery.
Promo Code	String	If the transaction was part of a promotion, this field will contain a value. This field is empty for all non-promotional items. For more information, see Promotional Codes.
Parent Identifier	String	If a song or a TV episode is sold individually instead of as a music album or TV season, this field will contain the playlist’s vendor ID you provided during content delivery. If no vendor ID has been provided, this field will be empty. If the price for a music album or TV season is not lower than the sum of each individual song or TV episode, the songs or episodes will be sold individually. The Parent Identifier field will contain the vendor ID of the album or TV season.
Parent Type ID	Int	If a song or TV episode is sold individually, this field will contain the sales type. The value “17” indicates that the song or TV episode was sold individually. If the price for a music album or TV season is not lower than the sum of each individual song or TV episode combined, the songs or episodes will be sold individually and the shown value will be “1.” Possible values include: 1 = Sold individually if sum of individual content that makes up the bundle is less than bundle 17 = Sold as individual purchase
Primary Genre	String	The genre associated with your content.

See alsoDetailed Sales Reports

Detailed Sales Reports

Report types: Daily and weekly

Requirement: At least one unit sold.

Report Field	Report Data Type	Notes
Provider	String	The service provider in your reports (typically Apple).
Provider Country	String	The service provider country code (typically U.S.).
Vendor Identifier	String	A unique vendor ID you provide us when submitting your content.
UPC	String	The identifying Universal Product Code you provide us when you deliver your content.
ISRC	String	The identifying ISRC you provide us when deliver your content.
Artist / Show	String	The primary artist or show title of the item. You provide this when you deliver your content.
Title	String	The title of the content. You provide this when you deliver your content.
Label / Studio / Network	String	The label, studio, or network you provide when you delivered the content.
Product Type Identifier	String	Defines the type of product. For more information, see Product Type Identifiers.
Units	Decimal	The aggregate number of units sold.
Royalty Price	Decimal	Royalty price for your content.
Download Date	Date	The date the customer downloaded the content (format MM/DD/YY).
Order ID	BigInt	The identifying order number of the customer’s transaction.
State Province	String	The state or province where the transaction occurred.
City	String	The city or metro area where the transaction occurred.
Masked User ID	String	A non-persistent, masked identifier that is unique to the user and changes every calendar month.
Report Date	Date	The reporting date of the Sales Detail report.
Sale / Return	String	Indicates if a transaction is a sale or return. Possible values include: S = Sale R = Refund
Customer Currency	String	Three character ISO code of the currency your proceeds are earned in. For more information, see Currency Codes.
Country Code	String	Two character ISO country code indicating the iTunes Store or Apple Music territory for the purchase. For more information, see Country Codes.
Royalty Currency	String	Three-character ISO code indicating the royalty currency. For more information, see Currency Codes.
PreOrder	String	Indicates if the transaction is a pre-order. If the purchase is not a pre-order, this field will be blank. Possible values include: P = Pre-Order
ISAN	String	The identifying ISAN you provide us when deliver your content.
Customer Price	Decimal	Price displayed on the iTunes Store.
Apple Identifier	BigInt	Unique Apple identifier for the given piece of content.
CMA	String	CMA sales are marked with CMA in the field. Song credits are marked CMA-C. Sales and refunds field are marked with R.
Asset / Content Flavor	String	Only applicable to TV content. High Definition content is marked with HD. Standard Definition is marked SD or blank.
Vendor Offer Code	String	Provided by you during content delivery.
GRid	String	The Global Release Identifier, provided by you during content delivery.
Promo Code	String	If the transaction was part of a promotion, this field will contain a value. This field is empty for all non-promotional items. For more information, see Promotional Codes.
Parent Identifier	String	If a song or a TV episode is sold individually instead of as a music album or TV season, this field will contain the playlist’s vendor ID you provided during content delivery. If no vendor ID has been provided, this field will be empty. If the price for a music album or TV season is not lower than the sum of each individual song or TV episode, the songs or episodes will be sold individually. The Parent Identifier field will contain the vendor ID of the album or TV season.
Parent Type ID	Int	If a song or TV episode is sold individually, this field will contain the sales type. The value “17” indicates that the song or TV episode was sold individually. If the price for a music album or TV season is not lower than the sum of each individual song or TV episode combined, the songs or episodes will be sold individually and the shown value will be “1.” Possible values include: 1 = Sold individually if sum of individual content that makes up the bundle is less than bundle 17 = Sold as individual purchase
Attributable Purchase	String	Indicates if the purchase can be attributed to a related action. (This currently only applies to music purchases originating from Radio. See note above.) Possible values include: RAP = Attributable to Radio Blank/Null = Attribution not applicable
Primary Genre	String	The genre associated with your content.

See alsoSummary Sales Reports

iTunes Content Demographic Reports

Report type: Daily

Requirement: At least five unique customers downloaded this content per each row in this file.

These contain aggregated information about customer age and gender, grouped by content.

Report Field	Type	Notes
Report Date	Date	The reporting date of the Sales report.
Country Code	String	Two-character ISO country code indicating the iTunes Store or Apple Music territory for the purchase. For more information, see Country Codes.
Apple Identifier	BigInt	Unique Apple identifier for the given piece of content.
Title	String	The title of the content, provided by you during content delivery.
Artist Name	String	The primary artist of the item, provided by you during content delivery.
Artist ID	BigInt	Apple identifier for the given artist. This will match the Artist ID used when delivering your content.
Label / Studio / Network	String	The label, studio, or network provided by you during content delivery.
Product Type Identifier	String	Defines the type of product. For more information, see Product Type Identifiers.
UPC	String	The identifying Universal Product Code, provided by you during content delivery.
ISRC	String	The identifying ISRC, provided by you during content delivery.
ISAN	String	The identifying ISAN, provided by you during content delivery.
GRid	String	The Global Release Identifier, provided by you during content delivery.
Vendor Identifier	String	The unique Vendor Identifier provided by you during content delivery.
Vendor Offer Code	String	The unique Vendor Offer Code provided by you during content delivery.
Parent Identifier	String	"If a song is sold individually instead of as a music album, this field will contain the song's vendor ID you provided during content delivery. If no vendor ID has been provided, this field will be empty. If the price for a music album is not lower than the sum of each individual songs, the songs will be sold individually. The Parent Identifier field will contain the vendor ID of the album."
Gender	Int	Indicates the gender of the listener. Possible values include: 0 = Data Unknown 1 = Male 2 = Female
Age Band	String	The age bucket the listener belongs to. Possible values include: 18-24 25-34 35-44 45-54 55-64 65+ Data Unknown
Customers	Decimal	The unique count of customers who downloaded the content.
Units	Decimal	The aggregate number of units sold.
Customers Last 7 Days	Decimal	The unique count of customers who downloaded the content across the previous 7 days. This is inclusive of the Customers provided for a single day.
Units Last 7 Days	Decimal	The aggregate number of units sold across the previous 7 days. This is inclusive of the Units provided for a single day.

Report type: Weekly, Monthly

Requirement: At least five unique customers downloaded this content per each row in this file. These contain aggregated information about customer age and gender, grouped by content.

Availability Weekly: Starts on Friday at 12:00:00 AM and ends on Thursday at 11:59:59 PM in the time zone for a territory.

Availability Monthly: Starts on the first day of the month at 12:00:00 AM and ends on the last day of the same month at 11:59:59 PM in the time zone for a territory.

Report Field	Type	Notes
Start Date	Date	The start date of the date range for this report.
End Date	Date	The end date of the date range for this report.
Country Code	String	Two-character ISO country code indicating the iTunes Store or Apple Music territory for the purchase. For more information, see Country Codes.
Apple Identifier	BigInt	Unique Apple identifier for the given piece of content.
Title	String	The title of the content, provided by you during content delivery.
Artist Name	String	The primary artist of the item, provided by you during content delivery.
Artist ID	BigInt	Apple identifier for the given artist. This will match the Artist ID used when delivering your content.
Label/Studio/Network	String	The label, studio, or network provided by you during content delivery.
Product Type Identifier	String	Defines the type of product. For more information, see Product Type Identifiers.
UPC	String	The identifying Universal Product Code, provided by you during content delivery.
ISRC	String	The identifying ISRC, provided by you during content delivery.
ISAN	String	The identifying ISAN, provided by you during content delivery.
GRid	String	The Global Release Identifier, provided by you during content delivery.
Vendor Identifier	String	The unique Vendor Identifier provided by you during content delivery.
Vendor Offer Code	String	The unique Vendor Offer Code provided by you during content delivery.
Parent Identifier	String	If a song is sold individually instead of as a music album, this field will contain the song's vendor ID you provided during content delivery. If no vendor ID has been provided, this field will be empty.If the price for a music album is not lower than the sum of each individual songs, the songs will be sold individually. The Parent Identifier field will contain the vendor ID of the album.
Gender	Int	Indicates the gender of the listener. Possible values include: 0 = Data Unknown 1 = Male 2 = Female
Age Band	String	The age bucket the listener belongs to. Possible values include: 18-24 25-34 35-44 45-54 55-64 65+ Data Unknown
Customers	Decimal	The unique count of customers who downloaded the content.
Units	Decimal	The aggregate number of units sold.

iTunes Artist Demographic Reports

Report type: Daily

Requirement: At least five unique customers downloaded this content per each row in this file.

These contain aggregated information about customer age and gender, grouped by artist.

Report Field	Type	Notes
Report Date	Date	The reporting date of the Sales report.
Country Code	String	Two-character ISO country code indicating the iTunes Store or Apple Music territory for the purchase. For more information, see Country Codes.
Artist Name	String	The primary artist of the item, provided by you during content delivery.
Artist ID	BigInt	Apple identifier for the given artist. This will match the Artist ID used when delivering your content.
Label / Studio / Network	String	The label, studio, or network provided by you during content delivery.
Gender	Int	Indicates the gender of the listener. Possible values include: 0 = Data Unknown 1 = Male 2 = Female
Age Band	String	The age bucket the listener belongs to. Possible values include: 18-24 25-34 35-44 45-54 55-64 65+ Data Unknown
Customers	Decimal	The unique count of customers who downloaded the content.
Units	Decimal	The aggregate number of units sold.
Customers Last 7 Days	Decimal	The unique count of customers who downloaded the content across the previous 7 days. This is inclusive of the Customers provided for a single day.
Units Last 7 Days	Decimal	The aggregate number of units sold across the previous 7 days. This is inclusive of the Units provided for a single day.

Report type: Weekly, Monthly

Requirement: At least five unique customers downloaded this content per each row in this file. These contain aggregated information about customer age and gender, grouped by content.

Availability Weekly: Starts on Friday at 12:00:00 AM and ends on Thursday at 11:59:59 PM in the time zone for a territory.

Availability Monthly: Starts on the first day of the month at 12:00:00 AM and ends on the last day of the same month at 11:59:59 PM in the time zone for a territory.

Report Field	Type	Notes
Start Date	Date	The reporting date of the Sales report.
End Date	Date	The reporting date of the Sales report.
Country Code	String	Two-character ISO country code indicating the iTunes Store or Apple Music territory for the purchase. For more information, see Country Codes.
Artist Name	String	The primary artist of the item, provided by you during content delivery.
Artist ID	BigInt	Apple identifier for the given artist. This will match the Artist ID used when delivering your content.
Label / Studio / Network	String	The label, studio, or network provided by you during content delivery.
Gender	Int	Indicates the gender of the listener. Possible values include: 0 = Data Unknown 1 = Male 2 = Female
Age Band	String	The age bucket the listener belongs to. Possible values include: 18-24 25-34 35-44 45-54 55-64 65+ Data Unknown
Customers	Decimal	The unique count of customers who downloaded the content.
Units	Decimal	The aggregate number of units sold.

Summary Pre-Order Reports

Report types: Daily, weekly, monthly, and yearly

Requirement: At least one unit ordered

Tip: To better understand the values below, view a sample report.

Report Field	Report Data Type	Notes
Provider	String	The service provider in your reports (typically Apple).
Provider Country	String	The service provider country code (typically U.S.).
Vendor Identifier	String	A unique vendor ID you provide us when submitting your content.
UPC	String	The identifying Universal Product Code you provide us when you deliver your content.
ISRC	String	The identifying ISRC you provide us when deliver your content.
ISAN	String	The identifying ISAN you provide us when deliver your content.
Artist/Show	String	The primary artist or show title of the item. You provide this when you deliver your content.
Title/Episode/Season	String	The title of the content. You provide this when you deliver your content.
Label/Studio/Network	String	The label, studio, or network you provide when you delivered the content.
Product Type Identifier	String	Defines the type of product purchased. For more information, see Product Type Identifiers.
PreOrder Start Date	Date	Start date of pre-order.
PreOrder End Date	Date	End date of pre-order.
Ordered	BigInt	The aggregated number of pre-orders for the period.
Canceled	BigInt	The aggregated number of canceled pre-orders for the period.
Fulfilled	BigInt	The aggregated number of fulfilled pre-orders for the period. Fulfilled orders are only considered “fulfilled” when a customer is successfully billed and has downloaded the purchased content.
Cumulative Ordered	BigInt	The total number of pre-orders.
Cumulative Canceled	BigInt	The total number of canceled pre-orders.
Cumulative Fulfilled	BigInt	The total number of fulfilled pre-orders.
Cumulative Open	BigInt	The total number of open pre-orders based on Cumulative Ordered, Cumulative Canceled, and Cumulative Fulfilled.
Start Date	Date	The start date of your pre-order summary date range.
End Date	Date	The end date of your pre-order summary date range.
Country Code	String	Two character ISO country code indicating the iTunes Store or Apple Music territory for the purchase. For more information, see Country Codes.
Apple Identifier	BigInt	Unique Apple identifier for the given piece of content.
PreOrder Apple Identifier	BigInt	The pre-order’s Apple Identifier.
Primary Genre	String	The genre associated with your content.

See alsoDetailed Pre-Order Reports

Detailed Pre-Order Reports

Report types: Daily and weekly

Requirement: At least one unit ordered.

Report Field	Report Data Type	Notes
Provider	Up to 100 Characters	The service provider in your reports (typically Apple).
Provider Country	Up to 100 Characters	The service provider country code (typically U.S.).
Vendor Identifier	Up to 20 Characters	A unique vendor ID you provide us when submitting your content.
UPC	Up to 20 Characters	The identifying Universal Product Code you provide us when you deliver your content.
ISRC	Up to 50 Characters	The identifying ISRC you provide us when deliver your content.
ISAN	Up to 50 Characters	The identifying ISAN you provide us when deliver your content.
Artist/Show	String	The primary artist or show title of the item. You provide this when you deliver your content.
Title/Episode/Season	String	The title of the content. You provide this when you deliver your content.
Label/Studio/Network	String	The label, studio, or network you provide when you delivered the content.
Product Type Identifier	String	Defines the type of product purchased. For more information, see Product Type Identifiers.
PreOrder Start Date	Date	Start date of pre-order.
PreOrder End Date	Date	End date of pre-order.
Ordered	BigInt	The aggregated number of pre-orders for the period.
Canceled	BigInt	The aggregated number of canceled pre-orders for the period.
Fulfilled	BigInt	The aggregated number of fulfilled pre-orders for the period. Fulfilled orders are only considered “fulfilled” when a customer is successfully billed and has downloaded the purchased content.
Cumulative Ordered	BigInt	The total number of pre-orders.
Cumulative Canceled	BigInt	The total number of canceled pre-orders.
Cumulative Fulfilled	BigInt	The total number of fulfilled pre-orders.
Cumulative Open	BigInt	The total number of open pre-orders based on Cumulative Ordered, Cumulative Canceled, and Cumulative Fulfilled.
Start Date	Date	The start date of your pre-order report date range.
End Date	Date	The end date of your pre-order report date range.
Country Code	String	Two character ISO country code indicating the iTunes Store or Apple Music territory for the purchase. For more information, see Country Codes.
Apple Identifier	BigInt	Unique Apple identifier for the given piece of content.
PreOrder Apple Identifier	BigInt	The pre-order’s Apple Identifier.
State Province	String	The state or province where the transaction occurred.
City	String	The city or metro area where the transaction occurred.
Masked User ID	String	A non-persistent, masked identifier that is unique to the user and changes every calendar month.
Primary Genre	String	The genre associated with your content.
¹ Apple generally does not modify this field. Whatever you provided when setting up your content is in the report. ² If you do not provide a value for this field, it will be empty.

See alsoSummary Pre-Order Reports

Appendices

Country Codes

Country Code	Country Name	Country Code	Country Name	Country Code	Country Name
AE	United Arab Emirates	HU	Hungary	NO	Norway
AM	Armenia	ID	Indonesia	NZ	New Zealand
AO	Angola	IE	Ireland	PA	Panama
AR	Argentina	IL	Israel	PE	Peru
AT	Austria	IN	India	PH	Philippines
AU	Australia	IQ	Iraq	PK	Pakistan
BA	Bosnia and Herzegovina	IS	Iceland	PL	Poland
BE	Belgium	IT	Italy	PT	Portugal
BG	Bulgaria	JM	Jamaica	PY	Paraguay
BJ	Benin	JO	Jordan	QA	Qatar
BR	Brazil	JP	Japan	RO	Romania
BS	Bahamas	KE	Kenya	RS	Serbia
BT	Bhutan	KR	Republic Of Korea	RU	Russia
BW	Botswana	KW	Kuwait	RW	Rwanda
CA	Canada	KZ	Kazakstan	SA	Saudi Arabia
CD	Democratic Republic of the Congo	LB	Lebanon	SB	Solomon Islands
CG	Republic of Congo	LC	St. Lucia	SC	Seychelles
CH	Switzerland	LK	Sri Lanka	SE	Sweden
CI	Cote d’Ivoire	LR	Liberia	SG	Singapore
CL	Chile	LT	Lithuania	SI	Slovenia
CM	Cameroon	LU	Luxembourg	SK	Slovakia
CN	China	LV	Latvia	SL	Sierra Leone
CO	Colombia	LY	Libya	SN	Senegal
CR	Costa Rica	MA	Morocco	SR	Suriname
CZ	Czech Republic	MD	Republic Of Moldova	SV	El Salvador
DE	Germany	ME	Montenegro	TC	Turks and Caicos
DK	Denmark	MG	Madagascar	TD	Chad
DO	Dominican Republic	MK	Macedonia	TH	Thailand
DZ	Algeria	ML	Mali	TN	Tunisia
EC	Ecuador	MM	Myanmar	TO	Tonga
EE	Estonia	MO	Macau	TR	Türkiye
EG	Egypt	MR	Mauritania	TW	Taiwan
ES	Spain	MS	Montserrat	TZ	Tanzania, United Republic of
FI	Finland	MT	Malta	UG	Uganda
FR	France	MU	Mauritius	US	United States
GA	Gabon	MV	Maldives	UY	Uruguay
GB	United Kingdom	MW	Malawi	VC	St. Vincent and the Grenadines
GE	Georgia	MX	Mexico	VE	Venezuela
GR	Greece	MY	Malaysia	VN	Vietnam
GT	Guatemala	MZ	Mozambique	VU	Vanuatu
GY	Guyana	NA	Namibia	XK	Kosovo
HK	Hong Kong	NE	Niger	YE	Yemen
HN	Honduras	NI	Nicaragua	ZA	South Africa
HR	Croatia	NL	Netherlands	ZM	Zambia

Currency Codes

Currency Code	Currency Name
AUD	Australian Dollar
BRL	Brazilian Real
CAD	Canadian Dollar
CHF	Swiss Franc
DKK	Danish Krone
EUR	Euro
GBP	Pound Sterling
JPY	Japanese Yen
MXN	Mexican Peso
NOK	Norwegian Krone
NZD	New Zealand Dollar
SEK	Swedish Krona
USD	United States Dollar

Product Type Identifiers

Product Type Identifier	Type	Category	Description
S	Songs	Music	Song, standard (DRM protected)
H	Songs	Music	Song, Plus (DRM free)
U	Songs	Music	Song, upgrade (convert from DRM to DRM free)
P	Albums	Music	Album, standard (DRM protected)
I	Albums	Music	Album, Plus (DRM free)
W	Albums	Music	Album, upgrade (convert from DRM to DRM free)
V	Music Videos	Music	Music video, standard (DRM protected)
J	Music Videos	Music	Music video, Plus (DRM free)
X	Music Videos	Music	Music video, upgrade (convert from DRM to DRM free)
R	Ringtones	Music	DIY ringtone
PR	Ringtones	Music	Pre-cut ringtone
RX	Alert Tones	Music	Alert tone
9	Albums	Music	Music Pass
E	Films	Music	Concert film purchase
F	VOD	Music	Concert film rental
B	Audiobook	Audiobook	Book (only one format available)
M	Films	Film	Movie purchase
D	VOD	Film	Movie rental
Z	Second Session	Film	Digital copy (redemption of second session)
MB	Film Bundles	Film	Movie bundle
TE	Episodes	TV	TV episode purchase (library)
TS	Library Seasons	TV	TV season purchase (library)
SP or Q	Season Pass	TV	Sales of a Season Pass for a currently airing season
TER	TV Rental	TV	TV episode rental
G	Games	iPod Games	Sale of a game

Promotional Codes

The promo code field values indicate the type of code used. Only one value is possible per line in the report. Note that “null” means that this is a standard transaction. The values below can appear in the promo code field.

Promo Code	Description
CR - RW	Promotional codes where the proceeds have been waived. The customer price will be 0, and the proceeds will be 0.
CR - RB	Promotional codes where the proceeds have not been waived. The customer price and the proceeds will be greater than 0.
FREE	The customer price is free on the store, and the royalty price is 0.
GP	Purchase of a gift.

Understanding Units

Reports are designed to provide information about the activity of your content on the iTunes Store. This can result in many lines for a given product. For each product with an Apple ID and vendor ID, units are split into:

Storefront country code
Sales and refunds
Product type
Price
Promo code
Pre-order
Asset flavor

Examples

Below are example descriptions of how units are grouped and displayed in preview and in the downloaded reports.

Example 1: If you have one product and you are selling the product in the U.S., you will see one row (for U.S. sales). This example does not include refunds, price changes, or promo codes for that period.
Example 2: If you are selling 30 products in the U.S., and ten of the products have refunds, the preview and the downloaded report will have 40 rows. You will see one row for sales and one row for refunds.
Example 3: If you are selling 30 products in the U.S., and five products have a price change in the middle of the week, your full report and your previews will have 35 rows. You will see two lines per title with a price change.
Example 4: If you are selling 20 products in the U.S., and you have three products launching that were previously pre-orders during the week, your preview and downloaded report will contain 23 rows. You will see two lines per title with pre-order (marked with P) transactions separated from normal transactions.

Glossary

Streams
General
Stream	A song or video play with a duration over 30 seconds.
Artist	The primary and featured performer(s) of the content (compound artists are included).
Territory	The regions and countries of the users' storefronts.
Genre	The musical style of the content.
Content Type	The format of the content (e.g. song or music video).
Container Type	The location in which the play occurred, such as an album, playlist, radio station, or single track.
Container Sub-Type	The type of playlist or radio station.
Member Type	The combination of Subscription Type and Subscription Mode, describing the subscription of the user in the Streams dashboard. Subscription Type and Subscription Mode are separate fields in our download reports.
Device	The category of device (mobile, desktop) and operating system.
Online/Offline	The connectivity state of the device when the play occurred. Play is tagged as offline only when the device is disconnected from the network.
Label/Studio/Network	The label, studio, or network delivered by the provider.
Playlist/Radio Station	The name of the playlist or radio station streamed by the user.

Subscription Type
Voice Individual	A short, introductory individual subscription tier that is voice-forward, where speech is used to initiate plays on the service.
Individual Monthly	A direct monthly subscription for a single user.
Student Monthly	A discounted subscription for a user enrolled in a qualifying degree-granting University or College program.
Family Monthly	A direct monthly subscription for a family of up to six.
Indirect Individual Monthly	A subscription for a single user, started and billed via a third party (e.g., carrier subscriptions).
Indirect Family Monthly	A subscription for a family of up to six, started and billed via a third party (e.g., carrier subscriptions).
Voice Individual Monthly	A direct monthly voice-forward subscription, where speech is used to initiate plays on the service.
Individual Annual	A direct yearly subscription for a single user.
Individual Introductory	A free or nominal-fee subscription for an individual new to the service.
Student Individual Introductory	A free or nominal-fee subscription for a student new to the service.
Family Introductory	A free or nominal-fee subscription for a family new to the service.
Voice Individual Introductory	A free or nominal-fee voice-forward subscription, where speech is used to initiate plays on the service, for an individual new to the service.

Subscription Mode
Paid	A full-price subscription after the user has completed a trial or introductory offer.
Trial	A free introductory subscription for users new to the service.
Offer/Growth Offer	A free or nominal-fee subscription one month or longer, for users new to the service.
Gratis Trial	A 1-month free subscription for qualified users (1 month introductory or winback).
Extended Trial	A third-party-subsidized introductory subscription, free to the user.
Discounted Promo	A subsidized or discounted subscription associated with a promotion.
Preview	A short, introductory offer that does not require a credit card.

End Reason Type
Completed Play	The playback is complete when the playhead reaches the end of a song.
Paused	The playback was stopped or interrupted.
Skipped	The forward or backward buttons were used to change the song.
Manually Changed	The listener manually initiated playback of a song.
Other	All other reasons a play might end.

Source of Stream
Library	Streams originating from the user's Library.
Search	Streams originating from the Search tab.
Discovery	Streams originating from the Home, New, or Radio tabs.
External	Streams originating from outside of the app, such as from an external link.
MusicKit	Streams originating from a MusicKit app integration.
Now Playing	Streams originating from the Create Station option of the Now Playing section.
Voice	Streams originating from a Voice command.
Other	All other sources of streams.

Container Type
Single Track	Songs streamed outside of a container and treated as a Single.
Playlist	Songs streamed from within a playlist.
Album	Songs streamed from within an album.
Radio	Songs streamed from a Radio Station.

Container Sub-Type
Private User Playlist	A personal playlist created by the user.
Editorial Playlist	A playlist created and curated by an Apple editor.
Charts Playlist	A playlist ranking the top songs in Apple territories.
Artist Playlist	A playlist created and curated by an Artist.
Curator Playlist	A playlist created and curated by a third-party partner.
Editorial Station	A radio station created by an Apple editor.
Algorithm Station	A radio station algorithmically generated based on a general request (e.g. play songs by a specific artist, or play party songs).
Artist Station	A radio station that shuffles and plays songs only by the artist selected by the user.
Personal Station	A radio station algorithmically generated based upon the user's favorite tracks and listening preferences.
Format Station	A radio station based on a particular genre.
Seeded by Artist/Song	A radio station algorithmically generated based on a song or artist.
Autoplay Station	A radio station based on content in the play queue that is generated when the queue ends.
Discovery Station	An algorithmically-generated radio station, based upon the user’s listening preferences and only containing songs the user has never before listened to on Apple Music.
Personal Mix Playlist	A personal, algorithmically-generated playlist based upon the user's listening preferences.
New Music Mix	A personal, algorithmically-generated playlist, recommending new music to the user based upon their listening preferences.
Favorites Mix	A personal, algorithmically-generated playlist based upon the user's favorite tracks and listening preferences.
Chill Mix	A personal, algorithmically-generated playlist, recommending mellow tracks based upon the user's listening preferences.
Get Up! Mix	A personal, algorithmically-generated playlist, recommending upbeat tracks based upon the user's listening preferences.
Friends Mix	A personal, algorithmically-generated playlist based upon the listening preferences of the user’s friends on Apple Music.
Replay Mix	A personal playlist based on the user’s favorite tracks from each year the user has subscribed to the service.
Love Mood Station	An algorithmically-generated radio station playing songs about romantic love, falling in love, feeling amorous, and feelings that these experiences bring.
Heartbreak Mood Station	An algorithmically-generated radio station playing songs about heartbreak, unrequited love, breaking up, or sad love.
Feel Good Mood Station	An algorithmically-generated radio station playing happy music with a positive vibe.
Feeling Blue Mood Station	An algorithmically-generated radio station playing moody music that helps you lean into feeling down.
Focus Mood Station	An algorithmically-generated radio station playing music to help you lock in to the task at hand.
Relax Mood Station	An algorithmically-generated radio station playing music that helps you find peace in the moment.
Energy Mood Station	An algorithmically-generated radio station playing upbeat music to get you moving.
Other Playlists and Stations	All other playlists and stations.
Non-Playlists and Radio Stations	All other plays originating from outside of the Playlist or Radio Station container.

Audio Format
Compressed Audio	Standard lossy audio (for example, 256 kbps AAC).
Lossless	High-quality, uncompressed audio.
Immersive	Atmos, 5.1, and 7.1 surround sound.