Build With RevenueCat

Build a customized mobile subscription business with RevenueCat. We do the heavy lifting of normalizing subscribers from any source and maintain a single source of truth for subscription status, so you can get back to building your app.

RevenueCat is a powerful, secure, reliable, and free to use in-app purchase server with global support. All you need to get started is an API key.

Get Started    REST API Endpoints

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 Campaign or Ad Group from the Apple Search Ads section.

View charts

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

  • Monthly Recurring Revenue
  • Revenue
  • New Purchases and Trials
  • Active Subscriptions and 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 (not set) 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.

Updated 4 months ago

Apple Search Ads

Collect and view Apple Search Ads attribution in RevenueCat

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.