Sales Reports

Use the Appstore Developer Console to review and download sales reports for your apps.

Access sales reports
- Sales reports page
- Downloadable sales reports
Download CSV sales report files
Fields in the sales report CSV file
- In-app subscription status

Access sales reports

To access sales reports, use the following steps

On the Developer Console dashboard, click the Reporting tab.
In the left menu, click Units.

Sales reports page

For the year that you have selected, you can view the reports by Months (the default) or by Marketplace.

When you expand a section, the table contains entries for each marketplace (in the Month view) or each month (in the Marketplace view). The fields in the table correspond to the fields in the CSV file (see table below).

The unit sales reports provide the total units sold. The data can be filtered by year, month, app and marketplace. The IAP and subscription units associated with a specific app are also shown. The report includes units sold and units returned.

Sales data is updated every 6 hours. The timestamp at the top of the page indicates when the data was last updated.

Sales are finalized only at the end of the month after earnings reports are generated, so the sales figures are subject to change within a given month.

Active subscribers and Active subscriptions provides a snapshot of most recent information and do not change with duration. The started, ended and refunded subscriptions are based on the selected time period.

Note: Sales reports are provided for your convenience only and are not binding. Please note that earnings in sales reports are only approximate and may not exactly match with the earnings reports.

Downloadable sales reports

Starting with the January 2018 report, sales reports contain transactional data, but 2017 and earlier reports contain summary sales data. The CSV table has the same format for both old and new reports. However, the information in the table will vary based on whether the report covers 2018 and later years, or 2017 and earlier years.

In the CSV files for a transactional sales report (2018 and later), you can derive ASIN level earnings by summing up the earnings column.

In the CSV files for 2017 and earlier years, aggregate sales by App/IAP is provided. You can derive ASIN level earnings by summing up the sales price and applying appropriate royalty adjustments for prior years.

The transactional sales reports are grouped based on the month that the invoice was opened. However, there are exceptions, where the transaction is applied to an earlier or a later month. The following examples illustrate possible scenarios:

Early transactions in the month

The Amazon payment system generally does not close invoices exactly on the last day of the month. Invoices may remain open for the first few days of the next month. Transactions that occur early in the next month are mapped to that open invoice until it is closed.

For example, if the invoice for February closes on March 3, the transactions from March 1-3 are included in the February invoice.

Late adjustment for a closed transaction

The Amazon payment system will not adjust a transaction in a closed invoice. The system records the adjustments in the currently open invoice for that vendor.

For example, in February 2018, a refund is reported for a transaction that occurred in October 2017. Since the invoice for September 2017 is already closed, the transaction is mapped to the currently open invoice, which is February 2018.

Download CSV sales report files

To download a sales report file, use the following steps

On the Developer Console dashboard, click the Reporting tab.
In the left menu, select Download Center.
In the main panel, select the type of the report you want to download.
Select the month of the report that you want to download. For earnings and payments reports, you can download the reports for the entire year.

Fields in the sales report CSV file

The CSV file is a text file with a .csv file extension. The CSV file must use UTF-8 encoding to support localized strings.

Warning: To properly support localized strings, make sure your text editing and spreadsheet tools are configured to support UTF-8.

The CSV file contains one header row, which displays the column titles. Each subsequent row in the file contains the information for one report item. The Invoice ID field defines a unique identifier for each line-item in the report.

The following table describes the fields for each entry (row) in the CSV file.

Field	Type	Description	Example
Marketplace	String	The Amazon marketplace	Amazon.com
Country/Region Code	String	Standard two-digit ISO country/region code for the origin of the transaction. Refer to this list	US
Invoice Id	String	The unique Id for the invoice. This field is set to NA for 2017 and older summary data	8dd921637-b092f385a7ee4- 62c6494b3ed702
Transaction Id	Integer	The unique Id associated with this transaction. This field is set to NA for 2017 and older summary data as the sales information includes all transactions in a given day	21854260140446
Transaction Time	String	The date and time of the transaction. Format is MM/DD/YY HH:MM:SS XST, with 00-23 as the range of hours. XST is the time zone associated with the marketplace of the transaction. For 2017 and older data, this field indicates the date of sale.	05/21/18 14:39 PST
Transaction Type	String	The transaction type is either Charge, Refund, Chargeback , or Chargeback reversal	Charge
Adjustment	Yes or No	This field is set to Yes if the transaction is an adjustment. For 2017 and older data, if the transaction type is Refund, this field will show a null value.	Yes
ASIN	Alphanumeric String	Amazon Standard Identification Number (ASIN) for the App/In-App/Subscription.	C00006M4PF
Vendor SKU	String	String of up to 150-characters that can include the characters a-z, A-Z, 0-9, underscores, periods, and dashes. The SKU is case-sensitive.	com.gamevendor.fungame
Title	String	The title of the app or game.	Smashemup Truck Game
Item Name	String	Name of the app, game, subscription, in-app item or in-game item.	Smashemup Truck Game
Item Type	String	The type of the item. Values include Subscription, In-App, Game, In-Game, or Application. An Application refers to an app purchase, which is a new app installation that is unique to an Amazon account. Application items do not include app updates.	Application
In-App Subscription Term	String	The term of the subscription. The term can be Weekly, BiWeekly, Monthly, BiMonthly, Quarterly, SemiAnnually, or Annually. This field is applicable only if the item type is Subscription. This field is not applicable to Twitch.	Weekly
In-App Subscription Status	String	The status can be TRIAL, PAID, Introductory Price - All Customers, or Promotional Price - Lapsed Customers. This field is applicable only if the item type is Subscription. For more details, see In-App Subscription Status. This field is not applicable to Twitch.	TRIAL
Units	Integer	Number of units included in this transaction.	1
Usage Time	String	The usage time for an Underground app (in seconds). This field is applicable only to Appstore underground products. To calculate the number of units, divide the usage time by 60. For example, usage time of 1200 is 20 units. This field is not applicable to Twitch.	1200
Marketplace Currency	String	The marketplace determines the currency of the transaction. See the Marketplace Timezones table.	USD
Sales Price	Marketplace Currency	Selling price that the customer sees after any discounts, not including sales tax. For underground apps, sales price represents the earnings based on number of minutes of app usage. Sales and earnings are the same for Underground apps. For adjustments, the sales price for the original item is shown. The actual adjusted amount or absolute refunded amount might be different than the sales price (such as a partial refund). For refunds and chargebacks (Transaction type - Refund, Chargeback), the equivalent sales price will be negative.	4.99
Estimated Earnings	Marketplace Currency	Estimate earnings after deducting for Amazon royalties from this transaction. For adjustments and refunds, earnings are shown based on the adjusted amount or the refunded amount. Refunds that are deducted from vendor's account are shown as negative values for reports having earnings corresponding to period from Nov'19 onwards.	3.49
App User ID	String	Unique customer identification for the transaction. App User ID is not available in the following scenarios: Item Type is “Application” Adjustment (Yes/No) is “Yes” The subscription is in "Paused" status	hQygC+MjonyR2Z0TMY03nyxeVxqIHq3+rK39TGzhkk0=
Receipt ID	String	Unique receipt identification for the transaction. Receipt ID is not available in the following scenarios: Item Type is “Application” Adjustment (Yes/No) is “Yes” The subscription is in "Paused" status	EgL-HstEAXhMfTuQ5_NkhQicjp_sRpJ5Lic78cF-3HY=:1:13
Digital Order ID	String	Unique order identification for the transaction.	d01-6680198-0475238
Device Type	String	The type of device in which the customer makes purchases. The type category 'Others' includes app purchases made on uncategorized device types (eg., app purchases through the web).	Fire TV
Sales channel	String	Identifier field used to delineate Quick Subscribe related purchases (Subscription and Application). Field value 'QS' indicates that the transaction is Quick Subscribe related.	QS

In-app subscription status

The possible values for the in-app subscription status field described are as follows:

TRIAL — Orders that are free of cost.
PAID — All paid orders except for introductory price and promotional price orders, described below.
Introductory Price - All Customers — Orders paid at an introductory price that was available to all customers (new and lapsed).
Promotional Price - Lapsed Customers — Orders paid at a promotional price that was available to lapsed customers only.

The introductory and promotional price values correspond to the promotional pricing plan configured by the developer.

Consider the following example.

A subscription plan is configured to offer a monthly free trial, followed by an introductory price for the first three months, followed by the regular plan.
The promotion type is classified as "Introductory Price - All Customers".

When a new customer purchases the subscription, the in-app subscription status of those orders appear as listed in the following table.

Order	Order Details	In-App Subscription Status
1st order	Free trial purchase	TRIAL
2nd order	Renewal with Introductory price	Introductory Price - All Customers
3rd order	Renewal with Introductory price	Introductory Price - All Customers
4th order	Renewal with Introductory price	Introductory Price - All Customers
5th and subsequent orders	Renewal with Regular price	PAID

Last updated: Sep 09, 2024