SDK8 AdMob Mediation Native

簡介

將說明如何將 TAmedia SDK 原生廣告與 Google AdMob 原生廣告(Native advanced)做 mediation 整合，關於 AdMob mediation 請參考：https://developers.google.com/admob/ios/mediate

串接準備

開始串接前請間確定已將 TAmedia SDK 整合至專案，並且完成初始化 SDK步驟，若您尚未完成請先參考開始使用教學完成相關設定。
確認已成功串接 AdMob 原生廣告，若還沒請參考 Google 教學AdMob原生廣告教學。新增自訂義事件請參考Google 說明。
最後，在專案中加入與 Custom Event 對應的 Class，其中 Custom Event 的 Class Name 需要和專案新增的 Class Name 保持一致，例如新增的 Class Name 為 TADCustomNative，Custom Event 的 Class Name 則必須是 專案名稱.TADCustomNative。（以 Swift 編寫的專案需加上專案名稱；若為以 OC編寫，則放入 Class Name）

整合方式

整合 AdMob 原生廣告需要兩個客製化 class，TADCustomNative 及 TADMediatedUnifiedNativeAd，可直接下載加入專案內或參考下方範例

TADCustomNative

AdMob 將透過這支程式來取得 TAmedia 廣告，其中關於 TADNativeAdOptions 及 TADMediaView 的客製化設定，可以自行參考教學文件進行設定，或保持預設值。

import Foundation
import GoogleMobileAds
import TAMediaAdsFramework

class TADCustomNative: NSObject, GADCustomEventNativeAd {
    weak var delegate: GADCustomEventNativeAdDelegate?
    private var nativeAd: TADNativeAd?
    
    override required init() {
        super.init()
    }
    
    deinit {
        print("TADCustomNative deinit")
    }
    
    func request(withParameter serverParameter: String, request: GADCustomEventRequest, adTypes: [Any], options: [Any], rootViewController: UIViewController) {
        loadTADNativeAd(adUnitId: serverParameter)
    }
    
    func handlesUserClicks() -> Bool {
        return true
    }
    
    func handlesUserImpressions() -> Bool {
        return true
    }
}

extension TADCustomNative {
    private func loadTADNativeAd(adUnitId: String) {
        let request = TADRequest()
        request.showLog = true
        let option = TADNativeAdOptions()
        ///參見 http://wiki.tamedia.com.tw/iosDoc/Classes/TADNativeAdOptions.html
//        option.disableImageLoading = true //SDK 將不自動下載圖片 TADMediatedUnifiedNativeAd 內需更改
//        option.mediaPreferImage = false //只會呈現圖片廣告
//        option.startUnmuted = true     //影片廣告會以非靜音方式呈現
//        option.customControlsRequested = true //
//        option.allowAudioSessionControl = false //設為false則需自行設定影音廣告出現時 AVAudioSession 狀態
        nativeAd = TADNativeAd(adUnitId: adUnitId)
        nativeAd?.delegate = self
        nativeAd?.load(request, withOption: option)
    }
}

extension TADCustomNative: TADNativeAdDelegate {
    func nativeAdDidReceive(_ ad: TADNativeAd!) {
        let nativeAdView = TADNativeAdView()
        let mediaView = TADNativeMediaView(frame: .zero)
        mediaView.mediaContent = ad.adContent.mediaContent
        ///參見 http://wiki.tamedia.com.tw/iosDoc/Classes/TADNativeMediaView.html
//        mediaView.setCallToActionVisible(false) //是否顯示 CTA 按鈕
//        mediaView.setCallToActionTextSize(12) //設定 CTA 文字大小
//        mediaView.setVolumeImageSize(24) //設定影音廣告靜音圖片大小
//        mediaView.setVideoCountdownTextSize(17) //設定影音倒數文字大小
        nativeAdView.addSubview(mediaView)
        nativeAdView.mediaView = mediaView
        
        let mapNativeAd = TADMediatedUnifiedNativeAd(tadNativeAd: ad, tadNativeAdView: nativeAdView)
        delegate?.customEventNativeAd(self, didReceive: mapNativeAd)
    }
    
    func nativeAd(_ ad: TADNativeAd!, didFailToReceiveAdWithError error: TADRequestError!) {
        delegate?.customEventNativeAd(self, didFailToLoadWithError: error)
    }
}

TADMediatedUnifiedNativeAd

將取得的 TAmedia 廣告整合後透過 AdMob 提供的介面回傳給 AdMob import Foundation import GoogleMobileAds import TAMediaAdsFramework class TADMediatedUnifiedNativeAd: NSObject { var tadNativeAd: TADNativeAd var tadNativeAdView: TADNativeAdView var mappedImages = [GADNativeAdImage]() var mapIcon: GADNativeAdImage? init(tadNativeAd: TADNativeAd, tadNativeAdView: TADNativeAdView) { self.tadNativeAdView = tadNativeAdView self.tadNativeAd = tadNativeAd super.init() self.tadNativeAd.delegate = self self.tadNativeAdView.mediaView?.statusDelegate = self guard let mediaContent = tadNativeAd.adContent.mediaContent else { return } if let tadImage = mediaContent.image1200x627?.image { let adImage = GADNativeAdImage(image: tadImage) tadNativeAdView.mediaView?.setMainImage(image: tadImage) mappedImages.append(adImage) } if let iconImage = tadNativeAd.adContent.iconSquare?.image { mapIcon = GADNativeAdImage(image: iconImage) } } deinit { print("TADMediatedUnifiedNativeAd - TADMediatedUnifiedNativeAd deinit") } } extension TADMediatedUnifiedNativeAd: TADNativeAdDelegate { func nativeAdDidImpression(_ ad: TADNativeAd!) { GADMediatedUnifiedNativeAdNotificationSource.mediatedNativeAdDidRecordImpression(self) print("TADMediatedUnifiedNativeAd - nativeAdDidImpression") } func nativeAdDidClick(_ ad: TADNativeAd!) { GADMediatedUnifiedNativeAdNotificationSource.mediatedNativeAdDidRecordClick(self) print("TADMediatedUnifiedNativeAd - nativeAdDidClick") } } extension TADMediatedUnifiedNativeAd: TADVideoStatusDelegate { func didStartVideo() { GADMediatedUnifiedNativeAdNotificationSource.mediatedNativeAdDidPlayVideo(self) } func didPlayVideo() { GADMediatedUnifiedNativeAdNotificationSource.mediatedNativeAdDidPlayVideo(self) } func didPauseVideo() { GADMediatedUnifiedNativeAdNotificationSource.mediatedNativeAdDidPauseVideo(self) } func didEndVideoPlayback() { GADMediatedUnifiedNativeAdNotificationSource.mediatedNativeAdDidEndVideoPlayback(self) } func didMuteVideo() {} func didUnmuteVideo() {} } extension TADMediatedUnifiedNativeAd: GADMediatedUnifiedNativeAd { var headline: String? { return tadNativeAd.adContent.longSubject } var images: [GADNativeAdImage]? { return mappedImages } var body: String? { return tadNativeAd.adContent.body } var icon: GADNativeAdImage? { return mapIcon } var callToAction: String? { return tadNativeAd.adContent.callToAction } var starRating: NSDecimalNumber? { return nil } var store: String? { return nil } var price: String? { return nil } var advertiser: String? { return nil } var extraAssets: [String: Any]? { return nil } var mediaView: UIView? { return tadNativeAdView.mediaView } var hasVideoContent: Bool { guard let mediaContent = tadNativeAd.adContent.mediaContent else { return false } return mediaContent.isVideoContent } func didRender(in view: UIView, clickableAssetViews: [GADNativeAssetIdentifier: UIView], nonclickableAssetViews: [GADNativeAssetIdentifier: UIView], viewController: UIViewController) { view.subviews.first { $0 is TADNativeAdView }?.removeFromSuperview() view.insertSubview(tadNativeAdView, at: 0) fillSuperView(view: tadNativeAdView) if let titleLabel = clickableAssetViews[GADNativeAssetIdentifier.headlineAsset] as? UILabel { titleLabel.isUserInteractionEnabled = true tadNativeAdView.longSubjectLabel = titleLabel } if let bodyLabel = clickableAssetViews[GADNativeAssetIdentifier.bodyAsset] as? UILabel { bodyLabel.isUserInteractionEnabled = true tadNativeAdView.bodyLabel = bodyLabel } if let ctaLabel = clickableAssetViews[GADNativeAssetIdentifier.callToActionAsset] { ctaLabel.isUserInteractionEnabled = true tadNativeAdView.callToActionView = ctaLabel } if let icon = clickableAssetViews[GADNativeAssetIdentifier.iconAsset] as? UIImageView { icon.isUserInteractionEnabled = true tadNativeAdView.squareImgeView = icon } if let mediaView = clickableAssetViews[GADNativeAssetIdentifier.mediaViewAsset], let tadMediaView = tadNativeAdView.mediaView { mediaView.subviews.first { $0 is TADNativeMediaView }?.removeFromSuperview() mediaView.addSubview(tadMediaView) fillSuperView(view: tadMediaView) } tadNativeAdView.nativeAd = tadNativeAd } func didUntrackView(_ view: UIView?) { print("TADMediatedUnifiedNativeAd - didUntrackView") tadNativeAdView.removeFromSuperview() tadNativeAdView.mediaView?.removeFromSuperview() } } extension TADMediatedUnifiedNativeAd { func fillSuperView(view: UIView) { view.frame = view.superview?.bounds ?? .zero } }

已知問題

點擊及曝光的事件當 TAmedia 廣告觸發後並沒有觸發 GADNativeAdDelegate 內 nativeAdDidRecordClick 及 nativeAdDidRecordImpression，目前推測為 Google SDK 的問題，若需要做相關紀錄須在 TADMediatedUnifiedNativeAd 內自行加入。

extension TADMediatedUnifiedNativeAd: TADNativeAdDelegate {
    func nativeAdDidImpression(_ ad: TADNativeAd!) {
        GADMediatedUnifiedNativeAdNotificationSource.mediatedNativeAdDidRecordImpression(self)
        print("TADMediatedUnifiedNativeAd - nativeAdDidImpression")
        /// 若需要紀錄曝光事件請在此自行加入
    }
    
    func nativeAdDidClick(_ ad: TADNativeAd!) {
        GADMediatedUnifiedNativeAdNotificationSource.mediatedNativeAdDidRecordClick(self)
        print("TADMediatedUnifiedNativeAd - nativeAdDidClick")
        /// 若需要紀錄點擊事件請在此自行加入
    }
}