How to get these dimensions and metrics in your workspace? | What do you need? |
Submit a data request. See Request new data in Funnel. | Business or Enterprise plan |
These fields come from the App Store Connect Summary Sales report.
Dimensions
Begin Date: Start date of report.
End Date: End date of report.
Provider: Service provider in your reports (typically Apple).
Provider Country: Service provider country code (typically U.S.).
Developer: Provider name provided by you during the initial account setup.
Name: App name provided by you during app setup.
SKU: Product identifier provided by you during app setup.
Apple Identifier: Your app's Apple ID.
Parent Identifier: SKU of the app associated with the in-app purchase.
Version: Version number provided by you during app setup.
Product Type Identifier: Defines the type of transaction (for example, initial download or update). See Product type identifiers in the Apple documentation.
Category: Indicates the primary category of the app, such as Games.
Supported Platforms: List of platforms that your app supports: iOS, tvOS, iOS and tvOS, or macOS.
Device: Type of device used for purchase or redownload: iPhone, iPad, Apple TV, iPod touch, or Desktop.
Client: Indicates where the purchase happened: App Store for iMessage, News, or blank.
Country Code: Two-character ISO country code indicating the App Store country or region through which the purchase was made.
Customer Currency: Three-character ISO code indicating the customer's currency.
Currency of Proceeds: The currency in which you are paid.
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.
Subscription: Defines whether an auto-renewable subscription is new or a renewal. When a previous subscriber resubscribes, it is classified as a renewal.
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: For Renew events, if the price is preserved then this field equals Yes. Otherwise, it is 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.
Order Type: 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.
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.
Metrics
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.
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 includes any applicable taxes that Apple collects and remits 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 Proceeds (per unit): 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.
Notes
Note: Apple generates App Store Connect reports in the background, and a report can take up to 24 hours to become available for download. Funnel can only download reports that Apple has finished generating, so expect at least a one-day delay before data appears after you connect or reconnect this data source. During this time, you might see a quota error or no data. This is expected and you don't need to do anything. The data source recovers automatically once Apple's reports are ready.
Today's data isn't available, because Apple generally makes reports available around 8 AM Pacific Time the next day. App Store Connect keeps sales reports for 1 year.
API documentation
For full field definitions, see the Apple Summary Sales report reference.
