SDK · iOS 16+ / macOS 13+
iOS AI ads SDK.
Native Swift SDK for monetizing iOS AI apps. SwiftUI and UIKit support, async/await first, App Store policy compliant.
Install
// Swift Package Manager .package(url: "https://github.com/surfacedd/surfacedd-ios", from: "1.0.0")
Import
import Surfacedd
Initialize
Surfacedd.configure(appId: "app_xxx")
Fetch a sponsored answer
let ad = try await Surfacedd.fetchSponsoredAnswer(context: .init(query: userMessage))
Features
- Swift Package Manager distribution
- SwiftUI SponsoredAnswerView and UIKit UIView support
- async/await and Combine APIs
- App Tracking Transparency (ATT) compliant
- iOS 16+, macOS 13+, visionOS 1+
Install in three steps
- Add the Swift Package. In Xcode: File → Add Package Dependencies, paste https://github.com/surfacedd/surfacedd-ios, and add to your target.
- Configure. Call Surfacedd.configure(appId: "app_xxx") in your App file or AppDelegate. Configuration is idempotent.
- Fetch and render. Use SponsoredAnswerView in SwiftUI (or UISponsoredAnswerView in UIKit) and bind to the user query. The view handles ad fetch, disclosure labeling, and click logging.
Frequently asked questions
Which iOS versions does the SDK support?
iOS 16 and above, macOS 13 and above, and visionOS 1 and above. The SDK uses modern concurrency features (async/await) and Swift 5.9 minimum.
Does it support ATT (App Tracking Transparency)?
Yes. The SDK respects the user's ATT choice. Contextual ad matching works without IDFA. Performance is similar across authorized and denied states because Surfacedd matches on query context, not cross-app tracking.
Can I use it inside a widget or Live Activity?
Sponsored units inside widgets are supported. Live Activities are not currently a supported placement because the disclosure label requirements conflict with the minimal UI.
Related SDKs
Ready to ship ads in your iOS app?
Join the waitlist for SDK access. 60% revenue share, no minimums, no contracts.