Skip to main content
Apple Ads in Qonversion (formerly Apple Search Ads) puts Apple Ads spend and delivery for your campaigns, ad groups and keywords next to the trials, payers and revenue of the users Qonversion attributes to Apple Ads. From the same report in the Qonversion dashboard you can pause and enable campaigns, ad groups and keywords, change keyword bids and change campaign daily budgets. AI agents and scripts read the same report through the Qonversion MCP server and REST API v4; programmatically, campaign changes are available only through the Qonversion MCP server. Setup takes three steps: an Owner or Administrator connects Apple Ads in the dashboard, your iOS app calls collectAppleSearchAdsAttribution(), and you read the report under the top-level Apple Ads item of the dashboard sidebar.

​
Who can use Apple Ads in Qonversion?

​
How do I set up Apple Ads in Qonversion?

1

Connect Apple Ads in the dashboard

An Owner or Administrator opens Settings → Connections → Apple Ads in the Qonversion dashboard and selects Connect with Apple: you sign in with Apple, choose the Apple Ads account and grant access. No private API key needs to be created or uploaded. The Apple Ads connection is stored per Qonversion project: connecting acts on the currently selected project only. A read-only Apple Ads role still powers full reporting; only campaign management needs a write-capable Apple Ads role. The status becomes Connected only after Apple confirms access. Qonversion records daily Apple Ads spend history from about the time you connect. Details: How do I connect Apple Ads to Qonversion?
2

Collect attribution with the Qonversion SDK

In your iOS app, call collectAppleSearchAdsAttribution() on every app launch, after Qonversion is initialized. Attribution collection is not automatic: without this call no token is sent. The token is requested only on iOS 14.3 and later, App Tracking Transparency consent is not required, and you must add AdServices.framework to the app target. User-level attribution does not need the Apple Ads connection, but readable campaign, ad group and keyword names replace Apple’s numeric IDs only when the project has a connected Apple Ads account that can access the campaign’s organization. Details: How do I collect Apple Ads attribution with the Qonversion SDK?
3

Read the Apple Ads report

Open the top-level Apple Ads item of the dashboard sidebar (path /apple-ads-report). Attribution is resolved asynchronously after the SDK sends the token, so attributed users appear some time after the app’s first launch. The report’s setup checklist has a step Attribution is matching that completes once at least one attributed user appears in the report. Details: How do I read the Apple Ads report in Qonversion?

​
What can I do in the dashboard, through MCP and through the REST API?

​
Which key concepts do I need to know?

  • Growing and Mature cohort windows. ROAS Dn and CAC Dn are shown in one of two readings: Growing (the default) counts what every install of the period has earned so far, and Mature uses only closed install dates. See Growing and Mature cohort windows.
  • ROAS versus ROAS Dn. ROAS (to date) includes immature cohorts and keeps growing daily, so it is not comparable with the ROAS Dn window columns. See Read ROAS and CAC.
  • Gross and Net. Gross revenue is what customers paid; Net revenue is store proceeds after the store commission and, where the store reports it, tax. Both are already net of refunds. See Revenue basis and refunds.
  • Total and Unallocated. The Total row is computed over the whole report, not as the sum of the rows on the page; the Unallocated row holds Apple spend with no matching attributed campaign. See What do the Total and Unallocated rows mean?
  • A dash means no value. An em dash — in a cell means no value — never $0 or 0. See Understand “—”.
  • Budget usage. Budget usage (7d) is the share of a campaign’s current daily budget spent over the last 7 complete UTC days; it does not depend on the report period you select. See What does the Budget usage column show?
  • Data freshness and UTC days. Qonversion’s report uses UTC days for every date, and spend history starts from about the time you connect; older history can be imported. See How fresh is Apple Ads data in Qonversion?
  • Currency. Money in the report is shown in the currency selected for analytics in the dashboard (USD by default), while bids and daily budgets stay in the Apple Ads account’s own currency. See Read spend in the report currency.

​
Which page answers my question?

​
What is not supported?

  • Apple Ads attribution on Android: the native Android SDK has no Apple Ads attribution.
  • Connecting or reconnecting Apple Ads through the REST API or MCP: a person must sign in with Apple in the dashboard.
  • Campaign changes over the plain REST API with a project Secret Key.
  • Changing ad-group bids, a campaign’s lifetime (total) budget, or anything other than status, keyword bid and campaign daily budget.
  • An ad (creative) level or a search-terms level in the report: the report has exactly three level tabs, Campaigns, Ad groups and Keywords.
  • Budget usage, CSV export, Update now and spend-history import outside the dashboard.