Apple Search Ads

Learn how to set up Apple Search Ads attribution

Adapty can help you get attribution data from Apple Search Ads and analyze your metrics with campaign and keyword segmentation.
There are two ways to get attribution: with old iAd framework and modern AdServices framework (iOS 14.3+).

AdServices Framework

Apple Search Ads via AdServices does require some configuration in Adapty Dashboard, and you will also need to enable on the app side.

Step 1

Add AdaptyAppleSearchAdsAttributionCollectionEnabled to the app’s Info.plist file and set it to YES (boolean value).

Step 2

Go to Adapty -> Setting -> Apple Search Ads.
You will find already generated public key (Adapty generates key pair for you). Copy public key.
Note: if you are using other services or own solution for ASA attribution, you can upload your own private key. Find docs below.

Step 3

Go to your Apple Search Ads account, then Settings -> User Management. You need to invite another Apple ID account and give it API Account Manager role.

Step 4

Log in into this newly added account and proceed to Settings -> API. Paste public key and generate credentials.

Step 5

Copy and paste Client ID, Team ID, and Key ID fields from Apple Search Ads settings to Adapty. That's it!

iAd Framework

🚧

Deprecated since iOS 14.5

This is old way to get Search Ads attribution. For more modern approach look into AdServices Framework.

Apple Search Ads via iAd Framework doesn't require any configuration in Adapty Dashboard, but you will need to enable it on the app side. Just add AdaptyAppleSearchAdsAttributionCollectionEnabled to the app’s Info.plist file and set it to YES (boolean value).

Uploading your own keys

📘

Optional

These steps are not required for Apple Search Ads attribution, only for working with other services.

You can use your own public-private key pair if you are using other services or own solution for ASA attribution.

Step 1

Generate private key in Terminal

openssl ecparam -genkey -name prime256v1 -noout -out private-key.pem

Upload it in Adapty Settings -> Apple Search Ads (Upload private key button)

Step 2

Generate public key in Terminal

openssl ec -in private-key.pem -pubout -out public-key.pem

You can use this public key in your Apple Search Ads settings of account with API Account Manager role. So you can use generated Client ID, Team ID, and Key ID values for Adapty and other services.