Android Interstitial Ads SDK8
簡介
TWMInterstitialAd 為全螢幕大小的廣告,使用方式與 TWMAdView 類似:請求廣告後,需在 onReceiveAd() 收到廣告之後呼叫 show() 才會顯示。
實作方式
1. 建立 TWMInterstitialAd
var interstitialAd: TWMInterstitialAd? = null
companion object {
const val TAMEDIA_INTERSTITIAL_AD_UNIT_ID: String = "INSERT_YOUR_AD_UNIT_ID"
}
// Other Implement ...
// 依序傳入 Activity、Ad Unit Id
interstitialAd = TWMInterstitialAd(this, TAMEDIA_INTERSTITIAL_AD_UNIT_ID)
2. 設定 TWMAdViewListener
透過 TWMAdViewListener 監聽廣告投放情況,並在 onReceiveAd 收到廣告後呼叫 show() 顯示廣告:
interstitialAd?.setAdListener(object : TWMAdViewListener {
override fun onReceiveAd(ad: TWMAd) {
// 表示本次請求收到廣告,呼叫 show() 顯示
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
}
})
3. 請求廣告
建立預設的 TWMAdRequest 物件,傳入 loadAd:
interstitialAd?.loadAd(TWMAdRequest())
4. 回收 TWMInterstitialAd
注意
請務必於 Activity.onDestroy() 呼叫 destroy(),即使插頁廣告沒有被顯示過。
override fun onDestroy() {
super.onDestroy()
interstitialAd?.destroy()
}
畫面展示
Jetpack Compose
在 Compose 中,TWMInterstitialAd 由 Activity 建立與回收;收到廣告後再由畫面決定何時呼叫 show()。以下為精簡範例,完整寫法請參考 SDK 下載包中的 Compose 範例程式 InterstitialComposeActivity。
class InterstitialComposeActivity : ComponentActivity() {
private lateinit var interstitialAd: TWMInterstitialAd
private var isAdReady by mutableStateOf(false)
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
interstitialAd = TWMInterstitialAd(this, "INSERT_YOUR_AD_UNIT_ID")
interstitialAd.setAdListener(object : TWMAdViewListener {
override fun onReceiveAd(ad: TWMAd) {
// 收到廣告,顯示「Show Ad」按鈕
isAdReady = true
}
override fun onFailedToReceiveAd(ad: TWMAd, errorCode: TWMAdRequest.ErrorCode) {
// 表示本次請求發生錯誤, 並沒有廣告內容可供使用
}
override fun onPresentScreen(ad: TWMAd) {}
override fun onDismissScreen(ad: TWMAd) {}
override fun onLeaveApplication(ad: TWMAd) {}
})
interstitialAd.loadAd(TWMAdRequest())
setContent {
if (isAdReady) {
Button(onClick = {
interstitialAd.show()
isAdReady = false
}) {
Text("Show Ad")
}
}
}
}
override fun onDestroy() {
super.onDestroy()
interstitialAd.destroy()
}
}
將應用程式的廣告請求標記為兒童導向內容(13 歲以下)
請於廣告請求時透過 TWMAdRequest.setChildDirectedTreatment(true) 告知 SDK 該廣告標記為兒童導向內容。此模式下不會存取與記錄 Android 裝置的 Google 廣告 ID(AAID)。
interstitialAd?.loadAd(TWMAdRequest().apply { setChildDirectedTreatment(true) })