|
| 1 | +# Teads - iOS AdMob Mediation Adapter |
1 | 2 |
|
| 3 | +This branch is dedicated to deliver TeadsAdMobAdapter through SPM |
2 | 4 |
|
3 | | -<br/> |
4 | | -<p align="center"> |
5 | | - <a href="https://teads.com/" target="_blank"> |
6 | | - <img width="75%" src="./ReadmeResources/teads_logo.png" alt="Teads logo"> |
7 | | - </a> |
8 | | -</p> |
9 | | -<br/> |
| 5 | +> Mediation adapter to be used in conjunction with AdMob to deliver Teads ads on iOS devices. |
10 | 6 |
|
11 | | ----- |
| 7 | +If you want to display Teads ads in your iOS application through AdMob mediation, you’re at the right place. |
12 | 8 |
|
13 | | -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. |
| 9 | +## Requirements |
14 | 10 |
|
| 11 | +-  |
| 12 | +-  |
| 13 | +-  |
| 14 | +-  |
15 | 15 |
|
16 | | -> **⚠️ Important ⚠️** |
17 | | -> |
18 | | -> ***Xcode 13*** |
19 | | -> |
20 | | -> In Xcode 13, Apple introduced an option to override the version number of every plist present inside your app (https://developer.apple.com/forums/thread/690647). Even those from third parties frameworks like TeadsSDK. We used to rely on the plist to retrieve the TeadsSDK version. To prevent this, we changed the way we checked the SDK version since version 5.0.6. So please update your integration to at least version 5.0.6. |
21 | | -> |
22 | | -> ***Xcode 13 + iOS 15 device*** |
23 | | -> |
24 | | -> [#155](https://github.com/teads/TeadsSDK-iOS/issues/155) building your application with **Xcode 13** and running it on **iOS 15 device** will crash when running TeadsSDK, we strongly advise to upgrade to [4.8.8 version](https://github.com/teads/TeadsSDK-iOS/releases/tag/v4.8.8) which fixes this crash |
25 | | -> |
26 | | -> You can still build and publish your app using Xcode 12 with older versions than 4.8.8 |
| 16 | +## Features |
27 | 17 |
|
28 | | -## 📃 Table of Contents |
| 18 | +- ✅ Displaying Teads banners |
| 19 | +- ✅ Displaying Teads native ads |
29 | 20 |
|
30 | | -- [Integration Documentation](#-integration-documentation) |
31 | | -- [Migrating from v4 to v5](#-migrating-from-v4-to-v5) |
32 | | -- [Run the sample app](#-run-the-sample-app) |
33 | | -- [Installation](#-install-the-teads-sdk-ios-framework) |
34 | | -- [Mediation Adapters](#-mediation-adapters) |
35 | | -- [Certifications](#-certifications) |
36 | | -- [Changelog](#%EF%B8%8F-changelog) |
37 | | - |
38 | | -## 🚀 Integration Documentation |
39 | | - |
40 | | -Integration instructions are available on [Teads SDK Documentation](https://support.teads.tv/support/solutions/articles/36000314785). |
41 | | - |
42 | | -## 🕊 Migrating from v4 to v5 |
43 | | - |
44 | | -TeadsSDK v5 introduces some changes regarding v4, see [Migration Documentation](https://support.teads.tv/support/solutions/articles/36000314772-migrating-from-v4-to-v5) |
45 | | - |
46 | | -## 🚲 Run the sample app |
47 | | - |
48 | | -Clone this repository, open it with Xcode, and run project. |
49 | | - |
50 | | -## 📦 Install the Teads SDK iOS framework |
51 | | - |
52 | | -Teads SDK is currently distributed through CocoaPods. It includes everything you need to serve "outstream" video ads. |
53 | | - |
54 | | -### Cocoapods |
55 | | - |
56 | | -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). |
57 | | - |
58 | | -```ruby |
59 | | -pod 'TeadsSDK', '~> 5.0' |
60 | | -``` |
61 | | - |
62 | | -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. |
63 | | - |
64 | | -```bash |
65 | | -pod install --repo-update |
66 | | -``` |
| 21 | +## Installation |
67 | 22 |
|
| 23 | +Before installing Teads adapter, you need to implement [Google Mobile Ads](https://developers.google.com/admob/ios/quick-start) in your application. |
68 | 24 |
|
69 | 25 | ### Swift Package Manager |
70 | 26 |
|
71 | 27 | [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. To integrate TeadsSDK into your Xcode project using SPM, specify package repository url : |
72 | 28 |
|
73 | | -``` |
74 | | -https://github.com/teads/TeadsSDK-iOS |
75 | | -``` |
76 | | - |
77 | | -Then select latest version available |
78 | | - |
79 | | -## 🤝 Mediation Adapters |
80 | | -- [Google AdMob](./MediationAdapters/TeadsAdMobAdapter/README.md) |
81 | | -- [Mopub](./MediationAdapters/TeadsMoPubAdapter/README.md) |
82 | | -- [AppLovin Max](./MediationAdapters/TeadsAppLovinAdapter/README.md) |
83 | | -- [Smart AdServer](./MediationAdapters/TeadsSASAdapter/README.md) |
84 | | - |
85 | | -## 🎓 Certifications |
86 | | - |
87 | | -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/). |
88 | | - |
89 | | - |
90 | | - |
91 | | - |
92 | | -## ⌚️ Changelog |
| 29 | +- Repository: `https://github.com/teads/TeadsSDK-iOS` |
| 30 | +- Dependency rule: `branch` |
| 31 | +- Branch: `admob-spm` |
93 | 32 |
|
94 | | -See [changelog here](https://github.com/teads/TeadsSDK-iOS/releases). |
| 33 | +## Integration Documentation |
95 | 34 |
|
| 35 | +Integration instructions are available on [Teads SDK Documentation](https://support.teads.tv/support/solutions/articles/36000314767-inread-google-ad-manager-and-admob-mediation). |
0 commit comments