Introduction
The Apple Dashboard is a ChurnIQ integration that connects directly to Apple App Store reporting. It enables you to track and analyze your mobile subscription performance within ChurnIQ, alongside other sales channels.
The dashboard ingests subscription-related metrics, such as revenue, subscriber numbers, growth trends, and retention, removing the need for manual data handling or third-party reporting tools.
This dashboard is available to all Cleeng users. It will appear in the Cleeng Dashboard > Analytics after you complete a one-time setup (described in the steps below).
Key benefits
- Gives you direct visibility into App Store subscription data inside ChurnIQ.
- Provides automated access to revenue, subscription growth, and retention metrics.
- Improves decision-making speed by centralizing reporting.
- Reduces manual work by eliminating the need for separate data exports or tools.
Metrics
- Apple Subscribers (Total): The number of subscribers who have access to the auto-renewable subscription, including entitled family members (if your service supports Apple Family Sharing). This field is only populated when the record represents more than 3 subscriptions.
- Apple Developer Proceeds (Total Revenue): The total amount you receive from transactions, calculated as the customer price minus applicable taxes and Apple’s commission, per Schedule 2 of your Paid Apps Agreement.
- Apple Transactions per Day: The volume of subscription-related transactions processed per day.
- Daily Subscriber Movement: Subscriber acquisition and churn at a daily level.
- Subscription Offer Breakdown: A visual breakdown showing how your subscribers are distributed across different subscription offers.
- Revenue by Country: Net subscription revenue (including refunds) and offer performance by country. Revenue is reported based on Apple’s fiscal calendar, with the start date representing the Apple fiscal period.
How does it work?
The Apple Dashboard connects to the Apple App Store reporting API using your App Store Connect credentials. Once the connection is established, subscription-related data (sales, renewals, cancellations, revenue) is retrieved on a daily basis (next-day data) and made available in ChurnIQ analytics.
How to set it up?
To start using the Apple Dashboard, you need to complete a one-time setup in Apple Store Connect and Cleeng.
Prerequisites
- Admin Access to your Apple Store Connect Account
Setup Steps
Step 1: Generate the App Store Connect keys
- Log in to Apple Store Connect and go to Users and Access > Integrations.
- From the Keys list on the left, select In-App Purchase.
- Click + to generate a new In-App Purchase key.
- Enter a name for your API key and click Generate.
-
Click Download In-App Purchase Key next to the key you generated.
Important: The key can only be downloaded once. Store it securely, as it is required for API authorization (JWT). - Keep this tab open. You will need to copy values from it in the next step.
Step 2: Configure the connection in Cleeng
- In a new tab, log in to the Cleeng Dashboard.
- Go to Admin & Tools > Integration Hub > Apple Store Reporting (under Data).
- Click on Configure and enter the configuration details collected from Apple:
- Issuer ID: Please see the screenshot below.
- Key ID: Please see the screenshot below.
- Private key: You can find it in the file you downloaded from Apple. The private key must be in PEM format. A valid PEM key starts with -----BEGIN PRIVATE KEY----- and ends with -----END PRIVATE KEY-----. Ensure there are no extra spaces or characters.
- Vendor ID: In Apple Store Connect, go to Payments and Financial Reports. The Vendor ID appears in the top-left corner below your Legal Entity Name.
Values to copy from Apple Store Connect:
Apple Store Reporting configuration in the Cleeng dashboard:
When ready, click on Connect Apple Store Reporting. Once completed, the connection is established, and data synchronization will start automatically.
FAQs
How does the Apple Total Developer Proceeds Revenue differ from the Total Revenue metric in the Transaction Value dashboard in ChurnIQ?
The Apple Total Developer Proceeds Revenue in the Apple Dashboard reflects only net proceeds from Apple App Store transactions, as reported by Apple, after applicable taxes and Apple’s commission. The Total Revenue metric in the Cleeng Transaction Value dashboard, on the other hand, aggregates all transactions across all payment providers, including Apple, into a single figure.
This means the Apple Dashboard provides a dedicated, Apple-only view, while the Transaction Value dashboard presents a consolidated, cross-provider total.
Which Cleeng plan do I need to use to view the dashboard (Pro, Enterprise)?
The Apple Analytics dashboard is available to all Cleeng users.
Is there a similar dashboard for Android/Google Play?
Yes, Cleeng offers a dedicated Dashboard for Google Play analytics (configuration instructions here).
More information
- Apple: Creating API keys to authorize API requests
- Apple: Developer Account help
- Cleeng's developer guide on integrating Apple in-app purchases using the StoreKit 2 framework