Prerequisites
- Import the Teads inApp SDK in your project.
- SmartCoreSdk: 7.14.0+
- SmartDisplaySdk: 7.14.0+
- AndroidX (⚠️ SmartSDK mandatory)
Installation
Before installing the Teads Smart adapter, you will need to integrate Smart SDK into your application.
Gradle
project/build.gradle
allprojects {
repositories {
...
maven { url "https://teads.jfrog.io/artifactory/SDKAndroid-maven-prod" }
maven { url 'https://packagecloud.io/smartadserver/android/maven2' }
}
}
app/build.gradle
dependencies {
...
implementation 'com.smartadserver.android:smart-core-sdk:7.14.0@aar'
implementation ("com.smartadserver.android:smart-display-sdk:7.14.0@aar") {
transitive = true
}
// Teads inApp SDK
implementation("tv.teads.sdk.android:sdk:5.x.x@aar") {
transitive = true
}
// Teads Smart Adapter
implementation 'tv.teads.sdk.android:smartadapter:5.x.x'
}
Defining a Custom Event
In order to display a Teads ad using Smart, you need to create a custom event.
Name | Value |
---|---|
SDK Name | TeadsSDK |
Ad Format Type | Banner |
Adapter Class | tv.teads.adapter.smart.SmartAdapter |
Placement Info | { "placementId": #PID#, "teadsAdSettingsKey": "[sas_kw | teadsAdSettingsKey]" } |
Please retrieve your production PID from your local account manager.
See this page for test PIDs and creative formats.
Important
Don't forget to replace the #PID# with your Teads placement ID.
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.
Initialize the TeadsHelper
first.
TeadsHelper.initialize()
You can instantiate a new listener as below, the listener needs to be a class member field or strong referenced somewhere,
we keep internally a weak reference to it, so it goes garbage collected when you don't need it anymore:
listener = object : TeadsAdapterListener {
override fun onRatioUpdated(adRatio: AdRatio) {
val params: ViewGroup.LayoutParams = adView.layoutParams
// Here the width is MATCH_PARENT
params.height = adRatio.calculateHeight(adView.measuredWidth)
adView.layoutParams = params
}
override fun adOpportunityTrackerView(trackerView: AdOpportunityTrackerView) {
}
}
Use the helper to attach a listener, it will return you a UNIQUE key to reference the current listener attached.
val key = TeadsHelper.attachListener(listener)
Finally, add it to your current ad settings for the specific ad request
val settings = TeadsMediationSettings.Builder()
.addAdapterListener(key)
.build()
val bannerPlacement = SASAdPlacement(
siteID,
pageName,
formatID,
SmartHelper.getTargetFromTeadsAdSettings(settings),
supplyChainObjectString
)
Mediation settings
Find the full settings list here
Check list
- ✅ Ensure Brand Safety is enabled
- ✅ Ensure you comply with privacy legal requirements (GDPR/CCPA/GPP)
- ✅ Comply with app-ads.txt
- ✅ Enable ad view resizing
- ✅ Test different PIDs with various ad formats and sizes
- ✅ Enable validation mode to ensure key features are working