ASO Documentation

AppSprint SDK

Add the AppSprint SDK to connect Apple Ads installs with RevenueCat or Superwall revenue. This setup is iOS-only and sends just the install signal AppSprint needs to match revenue back to keywords.

When to add it

Add the SDK after Apple Ads is connected and a RevenueCat or Superwall revenue provider is configured. RevenueCat can be verified with a test webhook; Superwall starts populating once real signed events arrive. The SDK sends Apple Ads install attribution so AppSprint can decode campaign, ad group, and keyword revenue.

Create the SDK prompt in the Mac app

Open Apple Ads, open return on ad spend setup, finish the revenue provider step, then pick iOS, Flutter, or React Native. Copy the generated prompt into your coding assistant.

Configure AppSprint once

In a blank app, the generated AppSprintAppleAds snippet should be the only AppSprint configure call. If the app already uses AppSprint, update that existing configuration with the key from the Mac app instead of adding a second AppSprint key or configure call.

The ASO setup does not need generic AppSprint events, sessions, customer IDs, IDFA updates, or tracking-link code.

Copy the snippet for your stack

Pick iOS, Flutter, or Expo / React Native, then copy the snippet into your app.

import AppSprintSDK
import RevenueCat

await AppSprintAppleAds.configure(apiKey: "YOUR_ASO_KEY")
let params = AppSprintAppleAds.getAttributionParams()
Purchases.shared.setAttributes(params)

Verify the connection

After the app receives an Apple Ads install, reopen return on ad spend setup in the Mac app. The SDK card shows install pings in the last 24 hours and the last time AppSprint received one.