https://github.com/teads/teadssdk-ios
Teads SDK for iOS - Premium branded "outstream" ads
https://github.com/teads/teadssdk-ios
admob advertising applovin-max cocoapods framework google-mobile-ads iab ios monetization open-measurement sdk swift swift-package-manager viewability webview xcode
Last synced: about 1 month ago
JSON representation
Teads SDK for iOS - Premium branded "outstream" ads
- Host: GitHub
- URL: https://github.com/teads/teadssdk-ios
- Owner: teads
- License: mit
- Created: 2015-02-26T17:02:38.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2025-01-14T15:09:50.000Z (9 months ago)
- Last Synced: 2025-04-09T23:19:17.762Z (6 months ago)
- Topics: admob, advertising, applovin-max, cocoapods, framework, google-mobile-ads, iab, ios, monetization, open-measurement, sdk, swift, swift-package-manager, viewability, webview, xcode
- Language: Objective-C
- Homepage: https://support.teads.tv/support/solutions/articles/36000314785-ios-sdk-developer-guide
- Size: 972 MB
- Stars: 27
- Watchers: 13
- Forks: 11
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Teads SDK for iOS
----
Teads allows you to integrate a single SDK into your app, and serve premium branded "outstream" video ads from Teads SSP ad server. This sample app includes Teads iOS framework and is showing integration examples.
## 📋 Table of Contents
- [Integration Documentation](#-integration-documentation)
- [Migrating from v4 to v5](#-migrating-from-v4-to-v5)
- [Run the sample app](#-run-the-sample-app)
- [Installation](#-install-the-teads-sdk-ios-framework)
- [Mediation Adapters](#-mediation-adapters)
- [Certifications](#-certifications)
- [Changelog](#%EF%B8%8F-changelog)
## 📚 Integration Documentation
- Integration instructions are available on [Teads SDK Documentation](https://support.teads.tv/support/solutions/articles/36000314785).
- Framework API documentation is available [here](https://teads.github.io/TeadsSDK-iOS/latest/)
## 🕊 Migrating from v4 to v5
TeadsSDK v5 introduces some changes regarding v4, see [Migration Documentation](https://support.teads.tv/support/solutions/articles/36000314772-migrating-from-v4-to-v5)
## 🚲 Run the sample app
Clone this repository, open it with Xcode, and run project.
## 📦 Install the Teads SDK iOS framework
### Cocoapods
To install the TeadsSDK just put this on your podfile, if you've never used cocoapods before please check the [offical documentation](https://guides.cocoapods.org/using/using-cocoapods.html).
```ruby
pod 'TeadsSDK', '~> 5.0'
```
On your terminal, go to the directory containing your project's `.xcodeproj` file and your Podfile and run `pod install` command. This will install Teads SDK along with our needed dependencies.
```console
pod install --repo-update
```
Before installing Teads adapter, you need to implement [Google Mobile Ads](https://developers.google.com/admob/ios/quick-start) in your application.
### Swift Package Manager
[SPM](https://swift.org/package-manager/) is a tool for managing the distribution of Swift code. It’s integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies.
#### Installing from Xcode
1. Add a package by selecting `File` → `Add Packages…` in Xcode’s menu bar.
2. Search for the Teads iOS SDK using the repo's URL:
```console
https://github.com/teads/TeadsSDK-iOS
```
3. Next, set the **Dependency Rule** to be `Up to Next Major Version` and keep `5.0.0 < 6.0.0`.
4. Choose the Teads product that you want to be installed in your app: `TeadsSDK`
#### Alternatively, add Teads to your Package.swift manifest
1. Add it to the `dependencies` of your `Package.swift`:
```swift
dependencies: [
.package(url: "https://github.com/teads/TeadsSDK-iOS", .upToNextMajor(from: "5.0.0"))
]
```
2. in any target that depends on a Teads product, add it to the `dependencies` array of that target:
```swift
.target(
name: "MyTargetName",
dependencies: [
// The product(s) you want (e.g. TeadsSDK).
.product(name: "TeadsSDK", package: "Teads"),
]
),
```
## 🤝 Mediation Adapters
- [Google AdMob](./MediationAdapters/TeadsAdMobAdapter/README.md)
- [AppLovin Max](./MediationAdapters/TeadsAppLovinAdapter/README.md)
- [Smart AdServer](./MediationAdapters/TeadsSASAdapter/README.md)
## 🎓 Certifications
Teads SDK supports the [IAB](https://www.iabcertification.com/) [Open Measurement](https://iabtechlab.com/standards/open-measurement-sdk/) SDK, also known as OM SDK. The OM SDK brings transparency to the advertising world, giving a way to standardize the viewability and verification measurement for the ads served through mobile apps. Teads is part of the [IAB's compliant companies](https://iabtechlab.com/compliance-programs/compliant-companies/).
## ⌚️ Changelog
See [changelog here](https://github.com/teads/TeadsSDK-iOS/releases).
Integration instructions are available on [Teads SDK Documentation](https://support.teads.tv/support/solutions/articles/36000314767-inread-google-ad-manager-and-admob-mediation).