What you get
What Qonversion reads from Apple
Qonversion authorizes against your Apple Ads account and pulls the campaign structure plus spend, impressions, taps and installs from Apple’s reporting API. Those Apple-sourced metrics — spend, impressions, taps, Apple-reported installs, average CPA, CPM and CPT, and keywords — need Apple Ads Advanced. Apple Ads Basic is supported for attribution. Qonversion still attributes installs and revenue through AdServices; Basic only lacks keyword data and access to Apple’s reporting API, so the Apple-sourced columns stay empty. See Apple’s comparison of Basic and Advanced. Columns from Qonversion — revenue, purchases, trials, subscriptions, ARPU, ARPPU — come from your own purchase data. Two counts that look alike and are not:- Installs are Apple’s tap-through conversions: a download within 30 days of a tap on the ad. Apple also reports view-through conversions with a one-day window, as a separate metric that is not in the Installs column.
- Users are customers the Qonversion SDK attributed through AdServices. So CPA is spend per Apple install, and CAC is spend per paying user; they answer different questions.
Where you read it
- In the dashboard — Analytics → Apple Search Ads; the menu item still carries Apple’s former product name. The newer Apple Ads report, with cohort windows and a Gross or Net revenue basis, is available to accounts with it enabled — contact support.
- Through REST API v4 — three read endpoints: the report, a daily series and the connection status. They use your project Secret Key and answer for accounts with Apple Ads enabled; other accounts receive
404. See Apple Ads in the API reference. - Through MCP — the same reads as tools for an agent, as a closed beta available to accounts with Apple Ads enabled — contact support. See Apple Ads via MCP.
D0 to Lifetime, let you compare campaigns of different ages instead of comparing a young cohort with an old one. They come in two readings. Growing counts everything observed so far and keeps moving; Mature counts closed cohort days only. Check which one you are looking at before quoting a number — and even a closed window can still change when a late refund arrives.
Qonversion reads your campaigns, ad groups and keywords from Apple Ads; you create and change them in Apple Ads.
How to connect Apple Ads
1
Connect with Apple
Open the Apple Ads settings of your Qonversion project and use Connect with Apple to choose the advertising account and grant access. You don’t need to create or upload a private API key. If your project still uses an Apple Ads API key, use Migrate to Apple authorization on the same page — and never send a private key or client secret to support. Details: Connect Apple Ads.
2
Enable attribution collection in the SDK
Call
collectAppleSearchAdsAttribution() after the Qonversion SDK is configured. The method name still carries Apple’s former product name. Call it regardless of how the user answered the tracking prompt — otherwise attribution is collected incompletely.3
Give the data time to arrive
Attributed installs appear after users open your app. Campaign metrics appear as Apple reports them, and Apple notes that a newly activated campaign can take 24–48 hours to gather performance data.
Next steps
Connect Apple Ads
Apple authorization, migrating from an API key, and the SDK method.
Read the Apple Ads report
Two kinds of installs, Growing and Mature windows, Gross and Net, comparing with the Apple console.
Apple Ads dashboard
Every available column, and whether it comes from Apple or from Qonversion.
Apple Ads in REST API v4
The report, the daily series and the connection status, read with a Secret Key.
Apple Ads via MCP
The tools an agent gets, the scopes they need, and the ways their output is easy to misread.
Remote Configs + A/B Tests
The campaign brought the users in — now decide what they see, and test it.