Apple Search Ads Integration

Qonversion automatically collects the attribution data for Apple Search Ads through its SDK and AdServices Framework. The attribution data and raw data export are available in the Qonversion Apple Search Ads dashboard.

1. Generate ASA credentials

1. Create a user with the API Account Manager role in your ASA account (you need the admin rights to create a user):
   Account Settings → User Management → Invite Users → Select the user role

2. Log in to your Apple Search Ads account using the user's credentials with API access created above.
   You need to create an OAuth client in the API settings. To generate private and public keys, please follow Apple's Documentation. Paste your public key including "BEGIN" and "END" headers to create client credentials. Download the private key, you will need it later:
   Account Settings → API → Client Credentials

🚧

Create a user with the API Account Manager role

If you authorize using the main account, the credentials screen might not always appear. To prevent this issue, create a user with an API access role and use that account to authorize and retrieve the public key.

3. Сopy and save clientId, teamId, keyId.
4. Fill Public Key with the public part of the certificate that you made in step 2.

2. Configure Qonversion with ASA credentials

1. Navigate to the Apple Search Ads settings in your Qonversion project

2. Provide your Client ID, Team ID, Key ID, Private key and save the information.

   1. Take Client ID, Team ID, Key ID from the Apple Search Ads account API settings page.
   2. Take Private Key from the private part of the certification mentioned above.

3. Configure SDK

3.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:

Qonversion.shared().collectAppleSearchAdsAttribution()

[[Qonversion sharedInstance] collectAppleSearchAdsAttribution];

Qonversion.getSharedInstance().collectAppleSearchAdsAttribution();

Qonversion.getSharedInstance().collectAppleSearchAdsAttribution();

Qonversion.GetSharedInstance().CollectAppleSearchAdsAttribution();

Qonversion.getSharedInstance().collectAppleSearchAdsAttribution();

Qonversion.getSharedInstance().collectAppleSearchAdsAttribution();

🚧

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

3.2 Import AdServices framework

Starting with iOS 14.3, Apple Search Ads campaigns are measured through a new self-attributing integration based on the AdServices framework.

👍

Done

You've successfully set up the Apple Search Ads attribution with Qonversion.
Wait for a day and check the attribution data in Apple Search Ads dashboard in your Qonversion account.

Please contact us using if you don't see the Apple Search Ads dashboard in your Qonversion account.