AppLovin MAX mediation - inRead

• Latest Version: iOS release notes
• Sample App: Teads iOS Sample App

1. Prerequisites
2. Installation
3. Create a custom Network
4. Enable Teads Custom Network in your ad unit
5. Integration
6. Integration
7. Ad Resizing
8. Mediation settings

---

This article shows you how to deliver Teads Native ads in your application using the AppLovin Mediation adapter.

Using CocoaPods to have Teads AppLovin mediation plugin will automatically import the Teads inApp SDK framework.

Sample App on GitHub
Teads inApp SDK iOS sample App

Prerequisites

• Platform: iOS 10+
• Xcode: 12.5+
• AppLovin SDK: 11.5.1+

Installation

Before installing the Teads AppLovin adapter, you will need to integrate AppLovin SDK into your application.

CocoaPods

If your project is managing dependencies through CocoaPods, you just need to add this pod in your Podfile.

It will install the Teads adapter along with the Teads inApp SDK.

1. Add Pod named TeadsAppLovinAdapter your Podfile:

pod 'TeadsAppLovinAdapter', '~> 5.1'

2. Run the following to install the adapter in your project.

$ pod install --repo-update to install

3. Follow the Defining a Custom Event step below to finish the integration.

Swift Package Manager

SPM 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:

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: TeadsAppLovinAdapter
5. Follow the Defining a Custom Event step below to finish the integration.

Alternatively, add Teads to your Package.swift manifest

1. Add it to the dependencies of your Package.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:

.target(
  name: "MyTargetName",
  dependencies: [
    .product(name: "TeadsAppLovinAdapter", package: "Teads"),
  ]
),

3. Follow the Defining a Custom Event step below to finish the integration.

Create a custom Network

In order to display a Teads ad using AppLovin, you need to create a custom Network.

Name	Value
Network Type	SDK
Custom Network Name	Teads
iOS Adapter Class Name	TeadsMediationAdapter

Enable Teads Custom Network in your ad unit

Edit your banner or MREC adUnit on AppLovin dashboard and enable it

Important

Both of Banner or MREC is supported. However, AppLovin provide an auto refreshing feature that isn't really compatible with Teads. We strongly recommend disabling it.

For MREC, you can set the refresh interval to No Interval but for Banner, you can't avoid this feature. In this case, we encourage you to set the max refresh interval.

See this article for more test PIDs serving different creative formats.

Name	Value
App ID
Placement ID	#PID

Important

Don't forget to replace the #PID# with your Teads placement ID.

Integration

Integration

Note

Check out the sample ViewController from our iOS GitHub repository

You have the ability to pass extra parameters in order to customize third-party ad network settings. For Teads, you need to pass TeadsAdapterSettings.

• Register your TeadsAdapterSettings into MAAdView using method register.

let adSettings = TeadsAdapterSettings { settings in
    settings.pageUrl("https://example.com/article1")
}
let bannerView = MAAdView(adUnitIdentifier: APPLOVIN_AD_UNIT_ID)
bannerView.register(teadsAdSettings: adSettings)

bannerView.loadAd()

Ad Resizing

The code below must be implemented to enable the resizing of the mediated ad slot making possible the rendering of square and vertical creatives.

Register to ad resizing through TeadsAdapterSettings by providing your delegate class and the MAAdView that need to be resized

var bannerView: MAAdView!
@IBOutlet weak var slotHeight: NSLayoutConstraint! // set to 0 on InterfaceBuilder

let adSettings = TeadsAdapterSettings { settings in
    settings.registerAdView(bannerView, delegate: self)
}

Simply conform to the Teads delegate TeadsMediatedAdViewDelegate and implements the didUpdateRatio function.

You can implement delegate as below, we keep internally a weak reference to it, so it's not retained when you don't need it anymore:

func didUpdateRatio(_ adView: UIView, adRatio: TeadsAdRatio) {
    let height = adRatio.calculateHeight(for: slotView.frame.width) // call calculateHeight
    slotHeight.constant = height //update NSLayoutConstraint of the slot
}

Mediation settings

Find the full settings list here