「Android Interstitial Ads SDK8」修訂間的差異

出自TAMedia
跳至導覽 跳至搜尋
imported>Wikiuser
imported>Wikiuser
 
(未顯示同一使用者於中間所作的 5 次修訂)
行 40: 行 40:


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


:或是,透過TWMAdRequest設置使用者生日,讓您的APP獲得更多元的廣告內容<br>
:或是透過TWMAdRequest設置使用者生日,讓您的APP獲得更多元的廣告內容<br>
{| class="wikitable"
{| class="wikitable"
|-
|-
行 77: 行 76:
<br><br>
<br><br>


<br><br>
*<span style="font-size:16px;">結束廣告</span>
: destroy() 必須被呼叫, 即使Interstitial沒有被使用到或參考
<source>
    interstitialAd.destroy()
</source>


== Interstitial畫面展示 ==
== Interstitial畫面展示 ==
行 88: 行 91:


<br><br>
<br><br>
[[Android SDK Developer Guide 2 | 回首頁]]
 
== <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>
    val interstitialAd: TWMInterstitialAd = TWMInterstitialAd(activity, adUnitId)
    interstitialAd.setAdListener(this)
    interstitialAd.loadAd(TWMAdRequest().apply {
        setChildDirectedTreatment(true)
    })
</source>
 
[[SDK8_Android_SDK_Developer_Guide | 回首頁]]

於 2022年3月3日 (四) 14:22 的最新修訂

簡介

SDK8

TWMInterstitialAd為全螢幕大小之廣告, 使用方法跟TWMAdView非常類似, 顯示廣告時需在onReceivedAd()之後呼叫show()函式以便顯示
注意:目前Interstitial廣告有相同版位ID在同一台裝置上,預設為120分鐘展示一次,如需調整請洽服務窗口



SDK Document

Interstitial

實作方式

  • 廣告初始設置
var interstitialAd : TWMInterstitialAd? = null
interstitialAd = TWMInterstitialAd(this ,TAMEDIA_INTERSTITIAL_ADUNITID)
companion object{
       const val TAMEDIA_INTERSTITIAL_ADUNITID: String = "{TAMEDIA_INTERSTITIAL_ADUNITID}"
}



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



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



  • 結束廣告
destroy() 必須被呼叫, 即使Interstitial沒有被使用到或參考
    interstitialAd.destroy()

Interstitial畫面展示

插頁式廣告呈現
SDK8 inerstitial.png



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


TWMAdRequest

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

回首頁