Configuration

​

Basic Configuration

import SwiftUI
import SpendOwl

@main
struct MyApp: App {
    init() {
        SpendOwl.configure(apiKey: "spendowl_live_xxx")
    }

    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: "spendowl_live_xxx")
        return true
    }
}

​

What Happens on Configure

1. Fetches attribution — Gets the Apple Search Ads attribution token and sends it to SpendOwl servers
2. Starts purchase tracking — Observes StoreKit 2 transactions for ROAS calculation
3. Initializes networking — Sets up the API client with retry logic

​

Advanced Configuration

let config = SpendOwlConfiguration(
    apiKey: "spendowl_live_xxx",
    timeoutInterval: 30,  // seconds
    maxRetries: 5
)
SpendOwl.configure(config)

​

Configuration Options

​

Check Configuration Status

if SpendOwl.isConfigured {
    // SDK is ready
    let attribution = try await SpendOwl.attribution()
}

​

API Key Best Practices

let apiKey = ProcessInfo.processInfo.environment["SPENDOWL_API_KEY"] ?? ""
SpendOwl.configure(apiKey: apiKey)

#if DEBUG
let apiKey = "spendowl_test_xxx"
#else
let apiKey = "spendowl_live_xxx"
#endif

SpendOwl.configure(apiKey: apiKey)

​

Thread Safety

​

Next Steps