TAMedia Wiki

Android InRead Ads SDK8

簡介

InRead廣告是SDK8新增的內嵌式廣告, 您可將廣告放置在文章、列表中, 當App使用者滑動到您指定的位置時便可看見InRead廣告, 若該廣告為影音廣告, 會等待廣告出現在畫面中才會進行撥放。
InRead廣告為:
  • TWMInReadAdAnchor: 固定在螢幕下方的廣告, 廣告高度不會超過螢幕的30%


  • SDK Document

    InRead

    廣告串接方式

    InRead

    InRead廣告, 不需事先設置XML或透過程式動態加入廣告View(addView), 只要直接初始InRead物件並請求廣告即可。

    Step 1: 廣告初始設置
    您必須依序輸入Activity、InRead Anchor版位ID以初始化InRead物件, 並且設置Listener偵聽廣告的Callback
    重要! 請務必在onResume、onPause和onDestroy分別加上resume、pause和destroy函式, 避免廣告發生無法預期的問題

     class InReadActivityKt:AppCompatActivity() {
       private var mTestResult: TextView? =null
       private var inread: TWMInReadAdAnchor? = null
       override fun onCreate(savedInstanceState: Bundle?) {
           super.onCreate(savedInstanceState)
           setContentView(R.layout.activity_inread)
           mTestResult = findViewById(R.id.inread_result)
           initAd()
       }
       private fun initAd() {
           inread = TWMInReadAdAnchor(this,TAMEDIA_INREAD_ANCHOR_ADUNITID)
           inread.apply {
               inread?.setAdListener(object : TWMAdViewListener {
                   override fun onReceiveAd(ad: TWMAd) {
                       // 表示本次請求收到廣告
                   }
                   override fun onFailedToReceiveAd(ad: TWMAd, errorCode: TWMAdRequest.ErrorCode) {
                       // 表示本次請求發生錯誤, 並沒有廣告內容可供使用
                   }
                   override fun onPresentScreen(ad: TWMAd) {
                       // 表示廣告內容已呈現
                   }
                   override fun onDismissScreen(ad: TWMAd) {
                       // 表示廣告內容已被關閉
                   }
                   override fun onLeaveApplication(ad: TWMAd) {
                       // 表示因點擊廣告或其他因素離開app
                   }
               })
           }
           inread?.loadAd(TWMAdRequest())
       }
       override fun onResume() {
           super.onResume()
           inread?.resume()
       }
       override fun onPause() {
           super.onPause()
           inread?.pause()
       }
       override fun onDestroy() {
           super.onDestroy()
           inread?.destroy()
       }
      
      companion object{
           const val TAMEDIA_INREAD_ANCHOR_ADUNITID: String = "{TAMEDIA_INREAD_ANCHOR_ADUNITID}"
       } 
     }


    Step 2: 請求廣告
    請求廣告前,你需要創建一個預設的TWMAdRequest物件, 並將TWMAdReqeust物件傳入loadAd

     inread?.loadAd(TWMAdRequest())


    結束廣告

    destroy() 必須被呼叫, 即使TWMInReadAdAnchor沒有被使用到或參考

      inread.destroy()

    廣告畫面展示

    InRead

    300px

    Compose new-xxl.png

    可參考SDK下載包中之Compose範例程式(InReadComposeActivity), 內有完整的使用方式與介紹

    應用程式開啟

    點擊InRead後開啟網頁

    無廣告內容

    SDK8.0.7_inread.png
    SDK8.0.7_inread_click.png
    SDK8.0.7_inread_no_fill.png



    將應用程式的廣告請求標記為兒童導向內容(13 歲以下)


    TWMAdRequest

    請於廣告請求時透過TWMAdRequest.setChildDirectedTreatment()告知SDK該廣告標記為兒童導向內容
    Android裝置的Google廣告ID (AAID) 於此模式時不會被存取與紀錄
        val inread: TWMInReadAdAnchor = TWMInReadAdAnchor(activity, adUnitId)
    
        inread.setAdListener(this)
    
        inread.loadAd(TWMAdRequest().apply {
    
            setChildDirectedTreatment(true)
    
        })

    回首頁