Apple Search Ads

Collect and view Apple Search Ads attribution in RevenueCat

With our Apple Search Ad integration you can:

  • Continue to follow your campaign's install base for months to understand the long-tail revenue generated from subscriptions, even without an app open.
  • Filter and segment RevenueCat charts by Apple Search Ad campaigns or ad groups.

1. Send attribution data to RevenueCat

The Purchases SDK can automatically collect Apple Search Ad attribution data as long as you import the iAd framework to your Xcode project and set automaticAttributionCollection = true.

import iAd
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    Purchases.automaticAppleSearchAdsAttributionCollection = true
    Purchases.configure(withAPIKey: "public_sdk_key", appUserID: "my_app_user_id")
    return true
#import <iAd/iAd.h>
- (BOOL)application:(UIApplication *)application 
  didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
  RCPurchases.automaticAppleSearchAdsAttributionCollection = YES;
  [RCPurchases configureWithAPIKey:@"public_sdk_key" appUserID:@"my_app_user_id"];


Don't forget to import the iAd framework to your XCode project.



Must request tracking permission in iOS 14.5+

On iOS 14.5+, you must be running the latest RevenueCat SDK and request authorization via the App Tracking Transparency framework before Apple Search Ads data can be collected by RevenueCat.

RevenueCat does not automatically request this permission from users.

2. View attribution data in RevenueCat

After the Purchases SDK has collected attribution for some users, you'll be able to segment and view charts for those conversions.

Choose conversion level

In the 'Select Segment' dropdown choose Apple search ads group or Apple search ads campaign from the Segment section.


View charts

Apple Search Ad attribution is available as segments and filters in the following charts:

  • Active Subscriptions
  • Churn
  • Refund Rate
  • Annual Recurring Revenue (ARR)
  • Monthly Recurring Revenue (MRR)
  • Revenue
  • Active Trials

Filter chart to compare individual campaigns or ad groups

Select and deselect rows to compare individual campaigns or ad sets



(not set)

The value of Organic is used to group transactions that are not attributed to an Apple Search Ads campaign. This means it was an organic install or users with limit ad tracking enabled.


Allow up to 7 days to gather attribution data

If your campaigns are new or you recently set up the Apple Search Ads integration, allow some time for RevenueCat to collect attribution and purchase data.