Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

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 5 hours ago
JSON representation

Teads SDK for iOS - Premium branded "outstream" ads

Awesome Lists containing this project

README

        

# Teads SDK for iOS



Teads logo

----

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/).

![iab certification badge](https://raw.githubusercontent.com/teads/TeadsSDK-iOS/master/ReadmeResources/OMCompliant.png)

## ⌚️ 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).