Apple Search Ads

How attribution works

1. On iOS 14.3+, the AppSprint SDK calls the AdServices framework to fetch an attribution token on first launch.
2. On older iOS versions, the SDK falls back to the legacy iAd framework.
3. The token is sent to the AppSprint API along with the install payload. The API resolves it with Apple's attribution endpoint to determine whether the install came from a Search Ads campaign.
4. When an Apple Search Ads account is connected in the dashboard, the API enriches the attribution with campaign name, ad group, keyword, and cost data from the Apple Search Ads API.

SDK setup

No additional SDK code is required. The iOS and React Native SDKs automatically detect and transmit the Apple Search Ads attribution token during configure(). Make sure your app includes the AdServices.framework (linked automatically in most setups).

Dashboard configuration

To connect your Apple Search Ads account and unlock campaign-level data:

1. Go to Dashboard → Your App → Integrations → Apple Search Ads.
2. Copy the public key displayed on the page.
3. In Apple Search Ads → Settings → API, upload the public key and create an API certificate.
4. Download the certificate file and upload it back in the AppSprint dashboard along with your orgId and clientId.
5. Once connected, the dashboard's attribution view will display campaign name, ad group, keyword, and match type for Search Ads installs.

Attribution data

When Apple Search Ads attribution is resolved, the following fields are available on the attribution object: