Skip to main content

Smart AdServer mediation - Media

This article shows you how to deliver Teads ads on your application using the Smart Ad Server Mediation adapter.

Sample App on GitHub Teads inApp SDK Android sample App

Prerequisites​

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:6.x.x@aar") {
    transitive = true
  }

  // Teads Smart Adapter
  implementation 'tv.teads.sdk.android:smartadapter:6.x.x'
}

Defining a Custom Event​

In order to display a Teads ad using Smart, you need to create a custom event.

NameValue
SDK NameTeadsSDK
Ad Format TypeBanner
Adapter Classtv.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 in the Integration Guide and Settings Configuration

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