Login
Welcome
Login

Native integration

This native implementation is specifically designed to fit feed views
You can customize the native ad view to have the same look and feel as the other views of your feed, it will offer an immersive experience.

Integration

Important

You are responsible for positioning the elements (title label, main image, call to action button…) Those elements need to be visible (without overlay, even transparent ones) otherwise our visibility algorithm will consider the ad view as hidden

The article is using the Native display test PID 124859. This PID is meant for testing purpose and shall not be released into production.

Interface

  1. Add the TeadsNativeAdView to the storyboard:
    Make sure Module TeadsSDK is set below Class TeadsNativeAdView

step1

  1. Create an outlet of the adView
@IBOutlet weak var adView: TeadsNativeAdView!
  1. Then you need to map all UI elements to TeadsSDK.TeadsNativeAdView:

step1

Note

Alternatively you can create your own xib with your own UIView, you need to create each UI Assets accordings to theses types:

  • titleLabel: UILabel
  • contentLabel: UILabel
  • mediaView: TeadsSDK.TeadsMediaView
  • iconImageView: UIImageView
  • advertiserLabel: UILabel
  • callToActionButton: UIButton
  • ratingView: UIView
  • priceLabel: UILabel

Load an Ad

You need to create a placement first, this placement is linked to your PID

class NativeDirectTableViewController : UIViewController, TeadsInReadAdPlacementDelegate { 

    @IBOutlet weak var tableView: UITableView!
    var placement: TeadsNativeAdPlacement?

    override func viewDidLoad() {
        super.viewDidLoad()
        let placementSettings = TeadsAdPlacementSettings { (settings) in
            settings.enableDebug()
        }
        placement = Teads.createNativePlacement(pid: Int(pid) ?? 0, settings: placementSettings, delegate: self)

        placement?.requestAd(requestSettings: TeadsAdRequestSettings(build: { (settings) in
            settings.pageUrl("https://example.com/article1")
        }))
    }

    ...
}

Store Ad (Sequence)

When implementing native in a tableView or collectionView we suggest to add TeadsNativeAd inside your sequence structure

private var elements = [TeadsNativeAd?]()

override func viewDidLoad() {
    super.viewDidLoad()

    (0..<8).forEach { _ in
        elements.append(nil) //nil reprensents all other data of cells
    }
    ...
}

implement didReceiveAd to store ad in you sequence structure

func didReceiveAd(ad: TeadsNativeAd) {
    ad.delegate = self // register to TeadsAdDelegate
    elements.insert(ad, at: adRowNumber) // store ad into sequence structure
    let indexPaths = [IndexPath(row: adRowNumber, section: 0)]
    tableView.insertRows(at: indexPaths, with: .automatic)
}

Ad Binding

func tableView(_ tableView: UITableView, cellForRowAt indexPath: IndexPath) -> UITableViewCell {
    if let ad = elements[indexPath.row] {
        guard let cell = tableView.dequeueReusableCell(withIdentifier: teadsAdCellIndentifier, for: indexPath) as? NativeAdTableViewCell else {
            return UITableViewCell()
        }
        cell.adView.bind(ad)
        return cell
    }
    ...
}

Note
if you choosed to create your own UIView, you need to bind every UI Asset manually

myTitleLabel.bind(ad.title)
myImageView.bind(ad.image)
...

Event Monitoring

The SDK provides a delegate to monitor events during the placemement life cycle

protocol TeadsInReadAdPlacementDelegate {
    // When the Teads inApp SDK has received an ad for you to bind
    func didReceiveAd(ad: TeadsSDK.TeadsNativeAd)
    // When Teads inApp SDK has failed to retrieve an ad
    func didFailToReceiveAd(reason: AdFailReason)
    // Not relevant for native
    func adOpportunityTrackerView(trackerView: TeadsAdOpportunityTrackerView)}

The SDK provides a delegate to monitor events during the ad life cycle and help you customize the ad experience in your apps.

protocol TeadsAdDelegate {
    // When an impression has occured
    func didRecordImpression(ad: TeadsAd)
    // When an event click has been fired
    func didRecordClick(ad: TeadsAd)
    // When the ad experience has experienced an issue
    func didCatchError(ad: TeadsAd, error: Error)
    // When the ad has been closed
    func didCloseAd(ad: TeadsAd)
    // Wwhen ad wants to present viewController modally e.g: safariViewController (Click to action)
    func willPresentModalView(ad: TeadsAd) -> UIViewController?
}

Check list

  • ✅ Ensure you comply with privacy legal requirements (GDPR/CCPA).
  • ✅ Comply with app-ads.txt
  • ✅ Test different test PIDs for multiple ad format and size testing
  • ✅ Enable Validation mode to ensure key features are working

Additional Settings

Find the full available TeadsAdPlacementSettings and TeadsAdRequestSettings settings here:

TeadsAdPlacementSettings { settings in
  // To enable debug logginer for Teads inApp SDK
  settings.enableDebug()
  // This is the CCPA string 
  settings.setUsPrivacy([US_PRIVACY])
  // Here is the GDPR informations
  settings.userConsent([SUBJECT_TO_GDPR], [CONSENT_STRING], .V2, sdkId)
}
TeadsAdRequestSettings { settings in
  // this turn on the validation tool to validate your integration
  settings.enableValidationMode()
  // this provide about context your current page for brand safety
  settings.pageUrl([http://example.com/article_1])
}

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.