檢視 Android Interstitial Ads SDK8 的原始碼

== <b>簡介</b> ==
SDK8
:<span style="font-size:16px;">TWMInterstitialAd為全螢幕大小之廣告, 使用方法跟TWMAdView非常類似, 顯示廣告時需在onReceivedAd()之後呼叫show()函式以便顯示<br/><b>注意：目前Interstitial廣告有相同版位ID在同一台裝置上，預設為120分鐘展示一次,如需調整請洽服務窗口</b></span>
<br><br>

== <b>SDK Document</b> ==
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-interstitial-ad/index.html Interstitial]
<br><br>

== <b>實作方式</b> ==
*<span style="font-size:16px;">廣告初始設置</span>
 var interstitialAd : TWMInterstitialAd? = null
 interstitialAd = TWMInterstitialAd(this ,TAMEDIA_INTERSTITIAL_ADUNITID)
 companion object{
        const val TAMEDIA_INTERSTITIAL_ADUNITID: String = "<b>{TAMEDIA_INTERSTITIAL_ADUNITID}</b>"
 }
<br><br>

*<span style="font-size:16px;">加入TWMAdViewListener監聽廣告投放情況，並在onReceiveAd Callback內呼叫showAd()</span>
:在<b>onReceiveAd</b>後可透過<b>showAd()</b>顯示廣告
 interstitialAd.setAdListener(object : TWMAdViewListener {
     override fun onReceiveAd(ad: TWMAd) {
          <b>// 表示本次請求收到廣告</b>
          interstitialAd?.show()
     }
     override fun onFailedToReceiveAd(ad: TWMAd, errorCode: TWMAdRequest.ErrorCode) {
          <b>// 表示本次請求發生錯誤, 並沒有廣告內容可供使用</b>
     }
     override fun onPresentScreen(ad: TWMAd) {
          <b>// 表示廣告內容已呈現</b>
     }
     override fun onDismissScreen(ad: TWMAd) {
          <b>// 表示廣告內容已被關閉</b>
     }
     override fun onLeaveApplication(ad: TWMAd) {
          <b>// 表示因點擊廣告或其他因素離開app</b>
     }
 })
<br><br>

*<span style="font-size:16px;">請求廣告</span>
:請求廣告前，你需要創建一個預設的TWMAdRequest物件
:並將TWMAdReqeust物件傳入loadAd
  interstitialAd?.loadAd(TWMAdRequest())

:或是，透過TWMAdRequest設置使用者生日，讓您的APP獲得更多元的廣告內容<br>
{| class="wikitable"
|-
! 使用Date !! 使用Calendar
|-
| style="width:60%; padding:1%;"|
  val adRequest = TWMAdRequest()
  try {
      <b>// 定義好時間字串的格式</b>
      val sdf = SimpleDateFormat("yyyy/MM/dd", Locale.getDefault())
      <b>// 將字串轉成Date型</b>
      val birthDate: Date = sdf.parse("1992/01/01")
      <b>// 將生日加入request</b>
      request.setBirthday(birthDate)
  } catch (e: Exception) {}
  
  <b>// 透過TWMAdRequest載入廣告</b>
  twmInterstitial.loadAd(request)
| style="width:40%; padding: 1%;"|
  <b>// 創建Calendar並設定生日 (注意! 月份的編號是由0至11)</b>
  val birthDate = Calendar.getInstance()
  <b>// 設定生日為1992/01/01</b>
  birthDate[1992, 1] = 1
  
  <b>// 將生日加入request</b>
  val request = TWMAdRequest()
  request.setBirthday(birthDate)
  
  <b>// 透過TWMAdRequest載入廣告</b>
  twmInterstitial.loadAd(request)
|}
<br><br>

== Interstitial畫面展示 ==
{|  border="1"
|-
| align="center" | 插頁式廣告呈現
|-
| align="center" | [[檔案:SDK8 inerstitial.png]]
|}

<br><br>

== <b>將應用程式的廣告請求標記為兒童導向內容(13 歲以下)</b> ==
<br>
[http://wiki.tamedia.com.tw/androidDoc/library/com.taiwanmobile.pt.adp.view/-t-w-m-ad-request/index.html TWMAdRequest]
<br>
<br>

:請於廣告請求時透過TWMAdRequest.setChildDirectedTreatment()告知SDK該廣告標記為兒童導向內容
:Android裝置的Google廣告ID (AAID) 於此模式時不會被存取與紀錄

<source>
    TWMInterstitialAd interstitialAd = TWMInterstitialAd(activity, adUnitId)
    interstitialAd.setAdListener(CusAdListener())
    interstitialAd.loadAd(TWMAdRequest().apply {
        setChildDirectedTreatment(true)
    })
</source>

[[Android SDK Developer Guide 2 | 回首頁]]