Skip to main content
Qonversion combines Apple Ads reporting with attribution collected by the Qonversion SDK and Apple’s AdServices framework. Connect your Apple Ads account first, then enable SDK collection. Read the report guide before comparing numbers with the Apple Ads console.

​
1. Connect with Apple

  1. Open Apple Ads settings for your Qonversion project. Your dashboard role must allow you to manage the project’s Apple Ads connection. If your plan doesn’t include Apple Ads, the settings page shows an Upgrade plan button and the connection can’t be started.
  2. Select Connect with Apple and finish authorization in Apple. Choose the Apple Ads account you want this project to use.
  3. Return to Qonversion and wait for the connection check. The page shows whether authorization is connected or still being verified. If it fails, use Check again or Reconnect with Apple on the same settings page.
You don’t need to create or upload a private API key. The status shows Verifying until Apple confirms access, then Connected.

​
Projects connected with an API key

If your project uses an Apple Ads API key, select Migrate to Apple authorization on the same page. Never send a private key or client secret to support or paste one into a chat.

​
2. Configure SDK

​
2.1 Enable Data Collection

After you have completed the first three steps from the Quick Start guide and have Qonversion SDK installed, enable data collection using the following SDK method:

​
Tips

  1. Run collectAppleSearchAdsAttribution method regardless of user App Tracking Transparency (ATT) response; it allows us to collect attribution in the most accurate way
  2. Make sure you are using Qonversion iOS SDK version 2.18.2 or above

​
2.2 Import AdServices framework

Starting with iOS 14.3, Apple Ads campaigns are measured through a new self-attributing integration based on the AdServices framework. Qonversion’s Apple Ads attribution uses the Apple Ads Attribution API (AdServices), so it works independently of SKAdNetwork — no SKAdNetwork postbacks are needed.

​
Done

You’ve set up Apple Ads attribution. Attributed installs appear in the Apple Ads dashboard after users open your app, and campaign metrics appear as Apple reports them — Apple notes a newly activated campaign can take 24–48 hours to gather performance data. If the dashboard stays empty, check the connection in Settings → Apple Ads, confirm your app calls collectAppleSearchAdsAttribution, and widen the date range.Please contact support if you don’t see the Apple Ads dashboard in your Qonversion account.
Apple Ads dashboard Analytics