Quickstart

1. Install the SDK

Add SpendOwl to your project using Swift Package Manager:

https://github.com/spendowl/spendowl-ios

Open Your Project

In Xcode, go to File → Add Package Dependencies…

Enter the URL

Paste https://github.com/spendowl/spendowl-ios

Add to Target

Select your app target and click Add Package

2. Configure on App Launch

SwiftUI
UIKit

import SwiftUI
import SpendOwl

@main
struct MyApp: App {
    init() {
        SpendOwl.configure(apiKey: "your-api-key")
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

import UIKit
import SpendOwl

@main
class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(
        _ application: UIApplication,
        didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?
    ) -> Bool {
        SpendOwl.configure(apiKey: "your-api-key")
        return true
    }
}

Get your API key from the SpendOwl Dashboard.

3. That’s It!

SpendOwl now:

Fetches attribution data from Apple Search Ads
Tracks StoreKit 2 purchases automatically
Sends data to your dashboard for ROAS calculation

Optional: Get Attribution Data

Access attribution data to display campaign info or for analytics:

Task {
    do {
        let attribution = try await SpendOwl.attribution()
        print("Campaign: \(attribution.campaignName ?? "organic")")
    } catch {
        print("Error: \(error)")
    }
}

Optional: Link User Identity

Associate attribution and purchases with your user accounts:

// After user logs in
SpendOwl.setUserId("user-123")

// On logout
SpendOwl.clearUserId()

Next Steps

Configuration

Customize timeouts, retries, and more

Attribution

Learn about attribution data

SwiftUI Example

See a complete SwiftUI app

Troubleshooting

Common issues and solutions

Introduction Installation

Getting Started

Resources

1. Install the SDK

2. Configure on App Launch

3. That’s It!

Optional: Get Attribution Data

Optional: Link User Identity

Next Steps

Configuration

Attribution

SwiftUI Example

Troubleshooting

​1. Install the SDK

​2. Configure on App Launch

​3. That’s It!

​Optional: Get Attribution Data

​Optional: Link User Identity

​Next Steps

Configuration

Attribution

SwiftUI Example

Troubleshooting

1. Install the SDK

2. Configure on App Launch

3. That’s It!

Optional: Get Attribution Data

Optional: Link User Identity

Next Steps