跳至主要内容

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()
}
}
應用程式開啟
應用程式開啟
點擊Interstitial後開啟網頁
點擊Interstitial後開啟網頁
無廣告內容
無廣告內容

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

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

interstitialAd?.loadAd(TWMAdRequest().apply { setChildDirectedTreatment(true) })

回首頁