Trends

Also known as "Sales and Trends", this report is based on Units (App Installs, Redownloads, Updates, or In-App Purchase Sales) and Developer Proceeds.

The Trends report is equivalent to the Trends menu you see on App Store Connect:

‍

About the Trends report

The Trends report is Apple's main report, officially maintained and distributed via their API.

This is your go-to report for Units - it contains Paid and Free downloads, Redownloads, Updates, In-App Purchases, App Bundles, etc, as well as Developer Proceeds.

Watch out, though, as this report doesn't include metrics such as Total Downloads, which can only be found in the Analytics Report. But don't let yourself underestimate the importance of this report: although it misses a few metrics, it is Apple's source of truth when calculating your Proceeds and Downloads.

‍

Comparing it to App Store Connect Trends

Login on App Store Connect;
Select the Trends tab on the top menu;
Select PST or UTM -8, as that's the timezone in which the data is published on the API.

‍

The ProductType Identifier

This dimension lets you break down your units into App Installs, In-App Purchases, Updates, and Re-downloads. Here's our summary of the main filters you might want to use:


If you want to see app installs only	ProductTypeIdentifier starts with 1
If you want to see all your in-app purchase sales	ProductTypeIdentifier starts with IA (or FI1 for Mac Apps)
If you want to see in-app subscription sales only	ProductTypeIdentifier starts with 1A9
If you want to see in-app auto-renewable subscription sales only	ProductTypeIdentifier starts with IAY
If you want to see updates only	ProductTypeIdentifier starts with 7
If you want to see re-downloads only	ProductTypeIdentifier starts with 3

See the full list of all ProductType Identifier codes on Apple's website.

‍

Confirming timezone discrepancies

To confirm that timezone differences cause any other discrepancies, you can do the following:

Go to the Trends menu
Select Units on the left-side menu
Change the timezone to PST (drop-down menu on the right side of the date picker)

It should look like this:

Doing this allows you to change the timezone to match what you see on the connector.

Fields included in this report

Proceeds Reason

If a subscription is 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.

Units

Aggregated number of units. Negative values indicate refunds or CMB credits for previously purchased apps when the CMB column shows "CMB-C". A value of 0 may indicate a partial refund.

Version

Version number provided by you during app setup.

Supported Platforms

List of platforms that your app supports

Provider

Service provider in your reports.

SKU

Product identifier provided by you during app setup.

Subscription

Defines whether an auto-renewable subscription is new or a renewal. When a previous subscriber resubscribes, it's classified as a renewal.

Provider Country

Service provider country code.

Promo Code

If the transaction was part of a promotion, this field will contain a value. This field is empty for all non-promotional items. Learn about promotional codes.

Preserved Pricing

If the price is preserved for Renew events, then this field equals “Yes”. Otherwise, it’s blank.

Product Type Identifier

Defines the type of transaction (for example, initial download or update). Learn about product type identifiers.

Period

Defines the duration of an auto-renewable subscription purchase: 7 days, 1 month, 2 months, 3 months, 6 months, and 1 year.

Order Type

For introductory or subscription offers, displays the type of transaction: Pay Up Front or Pay As You Go. For pre-orders, it indicates whether a purchase originated from a pre-order. For promotional offers, displays the order ID. For offer codes, displays the offer code reference name you entered in App Store Connect when setting up the subscription offer.

Parent Identifier

SKU of the app associated with the in-app purchase.

Name

App name provided by you during app setup.

End Date

End date of the report.

Device

Type of device used for purchase or redownload.

Developer

Provider name provided by you during the initial account setup.

Developer Proceeds (per unit)

The amount you receive per unit. This is the customer price minus applicable taxes and Apple’s commission, per Schedule 2 of your Paid Applications Agreement.

Customer Currency

Three-character ISO code indicating the customer’s currency. Learn about currency codes.

Currency of Proceeds

The currency in which the customer is paid. Learn about currency codes.

Customer Price

The price per unit billed to the customer, which you set for your app or in-app purchase in App Store Connect. *The customer price is inclusive of any applicable taxes we collect and remit per Schedule 2 of the Paid Applications Agreement. Negative values indicate refunds or CMB credits for previously purchased apps when the CMB column shows "CMB-C’".

Country Code

Two-character ISO country code indicating the App Store storefront through which the purchase was made. Learn about financial report regions and currencies.

CMB

If the transaction completes an app bundle, this field will contain a value of “CMB.” App credits for completed bundles will show a value of “CMB-C.” Otherwise, this field is blank.

Client

Indicates where the purchase happened:

Dimension Values Glossary

Begin Date

Date in MM/DD/YYYY

Start date of report.

End Date

Date in MM/DD/YYYY

End date of report.

Subscription

Up to 10 Characters

Defines whether an auto-renewable subscription is new or a renewal. When a previous subscriber resubscribes, it's classified as a renewal.

Promo Code

Up to 10 Characters

If the transaction was part of a promotion, this field will contain a value. This field is empty for all non-promotional items. Learn about promotional codes.

Device

Up to 10 Characters

Type of device used for purchase or redownload: Values include iPhone, iPad, iPod touch, Desktop, Apple TV, or Apple Vision.

Parent Identifier

Up to 100 Characters

SKU of the app associated with the in-app purchase.

SKU

Up to 100 Characters

Product identifier provided by you during app setup.

Version

Up to 100 Characters

Version number provided by you during app setup.

Supported Platforms

Up to 12 Characters

List of platforms that your app supports: iOS, macOS, tvOS, iOS and tvOS, visionOS, or iOS and visionOS.

Customer Price

Up to 18 Characters

The price per unit billed to the customer, which you set for your app or in-app purchase in App Store Connect. *The customer price is inclusive of any applicable taxes we collect and remit per Schedule 2 of the Paid Apps Agreement. Negative values indicate refunds or CMB credits for previously purchased apps when the CMB column shows "CMB-C’".

Units

Up to 18 Characters

Aggregated number of units. Negative values indicate refunds, or CMB credits for previously purchased apps when the CMB column shows "CMB-C". A value of 0 may indicate a partial refund.

Developer Proceeds (per unit)

Up to 18 Characters

Amount you receive per unit. This is the customer price minus applicable taxes and Apple’s commission, per Schedule 2 of your Paid Apps Agreement.

Country Code

Up to 2 Characters

Two-character ISO country code indicating the App Store country or region through which the purchase was made. Learn about financial report regions and currencies.

Proceeds Reason

Up to 20 Characters

If a subscription is 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.

Product Type Identifier

Up to 20 Characters

Defines the type of transaction (for example, initial download or update). Learn about product type identifiers.

Customer Currency

Up to 3 Characters

Three-character ISO code indicating the customer’s currency. Learn about currency codes.

Preserved Pricing

Up to 3 Characters

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

Order Type

Up to 30 Characters

For introductory or subscription offers, displays the type of transaction: Pay Up Front or Pay As You Go. For pre-orders, indicates whether a purchase originated from a pre-order. For promotional offers, displays the order ID. For offer codes, displays the offer code reference name you entered in App Store Connect when setting up the subscription offer.

Period

Up to 30 Characters

Defines the duration of an auto-renewable subscription purchase: 7 days, 1 month, 2 months, 3 months, 6 months, and 1 year.

Client

Up to 30 Characters

Indicates where the purchase happened: App Store for iMessage, News, or blank.

Developer

Up to 4000 Characters

Provider name provided by you during the initial account setup.

CMB

Up to 5 Characters

If the transaction completes an app bundle, this field will contain a value of “CMB.” App credits for completed bundles will show a value of “CMB-C.” Otherwise this field is blank.

Provider

Up to 5 Characters

Service provider in your reports (typically Apple).

Explore other connectors available at Easy App Reports

Trends

About the Trends report

Comparing it to App Store Connect Trends

The ProductType Identifier

Confirming timezone discrepancies

Fields included in this report

Dimension Values Glossary

Explore other reports from

App Store Connect

Explore other connectors available at Easy App Reports

The (only) data hub made for apps