
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.
Fields included in this report
| Field | Definition |
|---|---|
| Apple Identifier | Your app's Apple ID. |
| Begin Date | Start date of the report. |
| 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. |
| Category | Indicates the primary category of the app, such as Games. |
| Client | Indicates where the purchase happened: |
| 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. |
| Currency of Proceeds | The currency in which the customer is paid. Learn about currency codes. |
| Customer Currency | Three-character ISO code indicating the customer’s currency. 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’". |
| 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. |
| Device | Type of device used for purchase or redownload. |
| End Date | End date of the report. |
| Name | App name provided by you during app setup. |
| 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. |
| Period | Defines the duration of an auto-renewable subscription purchase: 7 days, 1 month, 2 months, 3 months, 6 months, and 1 year. |
| Preserved Pricing | If the price is preserved for Renew events, then this field equals “Yes”. Otherwise, it’s blank. |
| 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. |
| Product Type Identifier | Defines the type of transaction (for example, initial download or update). Learn about product type identifiers. |
| 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. |
| Provider | Service provider in your reports. |
| Provider Country | Service provider country code. |
| 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. |
| Supported Platforms | List of platforms that your app supports |
| 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. |
Dimension Values Glossary
| Report Field | Dimension Value | Definition |
|---|---|---|
| Begin Date | Date in MM/DD/YYYY | Start date of report. |
| Category | Up to 50 Characters | Indicates the primary category of the app, such as Games. |
| Client | Up to 30 Characters | Indicates where the purchase happened: App Store for iMessage, News, or blank. |
| 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. |
| 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. |
| Customer Currency | Up to 3 Characters | Three-character ISO code indicating the customer’s currency. Learn about currency codes. |
| 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’". |
| Developer | Up to 4000 Characters | Provider name provided by you during the initial account setup. |
| 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. |
| 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. |
| End Date | Date in MM/DD/YYYY | End date of report. |
| Name | Up to 600 Characters | App name provided by you during app setup. |
| 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. |
| Parent Identifier | Up to 100 Characters | SKU of the app associated with the in-app purchase. |
| 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. |
| Preserved Pricing | Up to 3 Characters | For Renew events, if the price is preserved then this field equals “Yes”. Otherwise, it’s blank. |
| 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. |
| 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. |
| Provider | Up to 5 Characters | Service provider in your reports (typically Apple). |
| SKU | Up to 100 Characters | Product identifier provided by you during app setup. |
| 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. |
| Supported Platforms | Up to 12 Characters | List of platforms that your app supports: iOS, macOS, tvOS, iOS and tvOS, visionOS, or iOS and visionOS. |
| 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. |
| Version | Up to 100 Characters | Version number provided by you during app setup. |


