Skip to main content

Getting Started

info

Welcome to Teads SDK - The next generation of mobile monetization combining Teads' premium video advertising with Outbrain's content recommendation capabilities in a single, powerful SDK.

What is Teads SDK?​

Following the strategic merger of Teads and Outbrain, we've created a unified SDK that provides seamless access to both premium video advertising and content recommendation capabilities through a modern, unified interface.

Perfect for iOS developers who want to:

  • Display premium video advertisements within their content
  • Show content recommendation widgets to increase user engagement
  • Monetize their apps with a single, comprehensive solution

Compatibility and Requirements​

The Teads SDK is a modern framework designed for iOS 14.0 and above, with support for both UIKit and SwiftUI applications.

Teads SDKRequirements
iOSiOS 14.0+ (deployment target)
Xcode26.2+ (required — the framework is built with the Swift 6.2.3 toolchain, and older toolchains cannot link against it)
Swift compilerThe framework is compiled with 6.2.3, which is the toolchain shipped in Xcode 26.2
Swift language modeSwift 5 (SDK compiled with SWIFT_VERSION = 5.0). Library evolution is enabled, so your app can use either the Swift 5 or Swift 6 language mode — migrating to Swift 6 is not required
Swift runtimeShips with the OS. Swift has been ABI-stable since Swift 5, so no Swift runtime is embedded in your app
Objective-CSupported — the SDK exposes an Objective-C compatible interface
UI FrameworksUIKit and SwiftUI
Dependency managersCocoaPods, Swift Package Manager, or a manually embedded XCFramework

Quick Start Overview​

Get up and running with Teads SDK in 3 simple steps:

1. Install the SDK​

Choose your preferred installation method and add the SDK to your project. → See Installation Guide

2. Initialize & Configure​

Set up the SDK in your app with just a few lines of code.

3. Add Placements​

Implement video ads or content recommendations where you want them. → See Integration Guide

What You Can Build​

Placement Types​

  • Media Placement - Premium video advertising
  • Media Native Placement - Native video ads with custom layouts
  • Feed Placement - Content recommendations widget
  • Recommendations API - Programmatic content recommendations

Key Benefits​

  • Single SDK - Both video ads and content recommendations
  • Privacy-First - Built-in GDPR, CCPA, and GPP compliance
  • Performance Optimized - Lightweight with minimal app impact
  • Mediation Ready - Works with Google Ad Manager, AdMob, AppLovin MAX, Smart AdServer

Quick Setup​

Initialize the SDK​

Add this to your AppDelegate or SwiftUI App:

import TeadsSDK

// In AppDelegate or SwiftUI App init
Teads.configure(with: "YOUR_PARTNER_KEY") // Optional for video ads

Basic Implementation​

Video Ad Example:

let config = TeadsAdPlacementMediaConfig(pid: 84242, articleUrl: URL(string: "https://example.com/article/123"))
let mediaPlacement = TeadsAdPlacementMedia(config, delegate: self)
let adView = try mediaPlacement.loadAd()
// Add adView to your UI

Content Recommendations Example:

let config = TeadsAdPlacementFeedConfig(
    articleUrl: URL(string: "https://example.com/article/123")!,
    widgetId: "MB_1",
    installationKey: "YOUR_INSTALLATION_KEY"
)
let feedPlacement = TeadsAdPlacementFeed(config, delegate: self)
let feedView = try feedPlacement.loadAd()
// Add feedView to your UI
tip

Need more details? The examples above are simplified. Check the Integration Guide for complete implementation including delegate methods, error handling, and UI integration.

Where to Go Next​

Essential Guides​

Migration Guides​

Advanced Features​

Requirements​

See Compatibility and Requirements above for supported iOS, Xcode, and Swift versions.

Support & Resources​

📞 Get Help​

Apple Compliance​

tip

Ready to start? Follow the Integration Guide for complete step-by-step instructions.