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

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​

  • iOS 14.0+ (deployment target)
  • Xcode 16.4+
  • Swift or Objective-C
  • UIKit or SwiftUI

Support & Resources​

📞 Get Help​

Apple Compliance​

tip

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